ETH Price: $1,989.23 (-1.78%)

Transaction Decoder

Block:
23108995 at Aug-10-2025 06:53:35 AM +UTC
Transaction Fee:
0.000019452740883792 ETH $0.04
Gas Used:
56,816 Gas / 0.342381387 Gwei

Emitted Events:

421 GasZipV2.Deposit( from=[Receiver] LiFiDiamond, chains=57, amount=10000000000000, to=5469FC6E789EC93823C983106E9C7E8790A7F96A000000000000000000000000 )
422 LiFiDiamond.0xcba69f43792f9f399347222505213b55af8e0b0b54b893085c2e27ecbe1644f1( 0xcba69f43792f9f399347222505213b55af8e0b0b54b893085c2e27ecbe1644f1, 0000000000000000000000000000000000000000000000000000000000000020, d33bee137a009f7540f230eeadaebe5bb300f664f7c0e0069437d867a0c21163, 0000000000000000000000000000000000000000000000000000000000000140, 0000000000000000000000000000000000000000000000000000000000000180, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000005469fc6e789ec93823c983106e9c7e8790a7f96a, 000000000000000000000000000000000000000000000000000009184e72a000, 000000000000000000000000000000000000000000000000000000000000a4b1, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 000000000000000000000000000000000000000000000000000000000000000c, 6761735a69704272696467650000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000009, 5f617262697472756d0000000000000000000000000000000000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
0x2a37D63E...109Cc2762
(Gas.Zip: Contract Deposit v1)
0.526752642651321172 Eth0.526762642651321172 Eth0.00001
(Titan Builder)
15.464974752040842656 Eth15.464974763404042656 Eth0.0000000113632
0x5469FC6e...790a7f96A
0.00100003 Eth
Nonce: 0
0.000970577259116208 Eth
Nonce: 1
0.000029452740883792

Execution Trace

ETH 0.00001 LiFiDiamond.fc5f1003( )
  • ETH 0.00001 GasZipFacet.startBridgeTokensViaGasZip( _bridgeData=[{name:transactionId, type:bytes32, order:1, indexed:false, value:D33BEE137A009F7540F230EEADAEBE5BB300F664F7C0E0069437D867A0C21163, valueString:D33BEE137A009F7540F230EEADAEBE5BB300F664F7C0E0069437D867A0C21163}, {name:bridge, type:string, order:2, indexed:false, value:gasZipBridge, valueString:gasZipBridge}, {name:integrator, type:string, order:3, indexed:false, value:_arbitrum, valueString:_arbitrum}, {name:referrer, type:address, order:4, indexed:false, value:0x0000000000000000000000000000000000000000, valueString:0x0000000000000000000000000000000000000000}, {name:sendingAssetId, type:address, order:5, indexed:false, value:0x0000000000000000000000000000000000000000, valueString:0x0000000000000000000000000000000000000000}, {name:receiver, type:address, order:6, indexed:false, value:0x5469FC6e789eC93823c983106e9c7e8790a7f96A, valueString:0x5469FC6e789eC93823c983106e9c7e8790a7f96A}, {name:minAmount, type:uint256, order:7, indexed:false, value:10000000000000, valueString:10000000000000}, {name:destinationChainId, type:uint256, order:8, indexed:false, value:42161, valueString:42161}, {name:hasSourceSwaps, type:bool, order:9, indexed:false, value:false, valueString:False}, {name:hasDestinationCall, type:bool, order:10, indexed:false, value:false, valueString:False}], _gasZipData=[{name:receiverAddress, type:bytes32, order:1, indexed:false, value:5469FC6E789EC93823C983106E9C7E8790A7F96A000000000000000000000000, valueString:5469FC6E789EC93823C983106E9C7E8790A7F96A000000000000000000000000}, {name:destinationChains, type:uint256, order:2, indexed:false, value:57, valueString:57}] )
    • ETH 0.00001 GasZipV2.deposit( chains=57, to=5469FC6E789EC93823C983106E9C7E8790A7F96A000000000000000000000000 )
      File 1 of 3: LiFiDiamond
      // SPDX-License-Identifier: MIT
      pragma solidity 0.8.17;
      error TokenAddressIsZero();
      error TokenNotSupported();
      error CannotBridgeToSameNetwork();
      error ZeroPostSwapBalance();
      error NoSwapDataProvided();
      error NativeValueWithERC();
      error ContractCallNotAllowed();
      error NullAddrIsNotAValidSpender();
      error NullAddrIsNotAnERC20Token();
      error NoTransferToNullAddress();
      error NativeAssetTransferFailed();
      error InvalidBridgeConfigLength();
      error InvalidAmount();
      error InvalidContract();
      error InvalidConfig();
      error UnsupportedChainId(uint256 chainId);
      error InvalidReceiver();
      error InvalidDestinationChain();
      error InvalidSendingToken();
      error InvalidCaller();
      error AlreadyInitialized();
      error NotInitialized();
      error OnlyContractOwner();
      error CannotAuthoriseSelf();
      error RecoveryAddressCannotBeZero();
      error CannotDepositNativeToken();
      error InvalidCallData();
      error NativeAssetNotSupported();
      error UnAuthorized();
      error NoSwapFromZeroBalance();
      error InvalidFallbackAddress();
      error CumulativeSlippageTooHigh(uint256 minAmount, uint256 receivedAmount);
      error InsufficientBalance(uint256 required, uint256 balance);
      error ZeroAmount();
      error InvalidFee();
      error InformationMismatch();
      error NotAContract();
      error NotEnoughBalance(uint256 requested, uint256 available);
      // SPDX-License-Identifier: MIT
      pragma solidity 0.8.17;
      interface IDiamondCut {
          enum FacetCutAction {
              Add,
              Replace,
              Remove
          }
          // Add=0, Replace=1, Remove=2
          struct FacetCut {
              address facetAddress;
              FacetCutAction action;
              bytes4[] functionSelectors;
          }
          /// @notice Add/replace/remove any number of functions and optionally execute
          ///         a function with delegatecall
          /// @param _diamondCut Contains the facet addresses and function selectors
          /// @param _init The address of the contract or facet to execute _calldata
          /// @param _calldata A function call, including function selector and arguments
          ///                  _calldata is executed with delegatecall on _init
          function diamondCut(
              FacetCut[] calldata _diamondCut,
              address _init,
              bytes calldata _calldata
          ) external;
          event DiamondCut(FacetCut[] _diamondCut, address _init, bytes _calldata);
      }
      // SPDX-License-Identifier: MIT
      pragma solidity 0.8.17;
      import { LibDiamond } from "./Libraries/LibDiamond.sol";
      import { IDiamondCut } from "./Interfaces/IDiamondCut.sol";
      import { LibUtil } from "./Libraries/LibUtil.sol";
      contract LiFiDiamond {
          constructor(address _contractOwner, address _diamondCutFacet) payable {
              LibDiamond.setContractOwner(_contractOwner);
              // Add the diamondCut external function from the diamondCutFacet
              IDiamondCut.FacetCut[] memory cut = new IDiamondCut.FacetCut[](1);
              bytes4[] memory functionSelectors = new bytes4[](1);
              functionSelectors[0] = IDiamondCut.diamondCut.selector;
              cut[0] = IDiamondCut.FacetCut({
                  facetAddress: _diamondCutFacet,
                  action: IDiamondCut.FacetCutAction.Add,
                  functionSelectors: functionSelectors
              });
              LibDiamond.diamondCut(cut, address(0), "");
          }
          // Find facet for function that is called and execute the
          // function if a facet is found and return any value.
          // solhint-disable-next-line no-complex-fallback
          fallback() external payable {
              LibDiamond.DiamondStorage storage ds;
              bytes32 position = LibDiamond.DIAMOND_STORAGE_POSITION;
              // get diamond storage
              // solhint-disable-next-line no-inline-assembly
              assembly {
                  ds.slot := position
              }
              // get facet from function selector
              address facet = ds.selectorToFacetAndPosition[msg.sig].facetAddress;
              if (facet == address(0)) {
                  revert LibDiamond.FunctionDoesNotExist();
              }
              // Execute external function from facet using delegatecall and return any value.
              // solhint-disable-next-line no-inline-assembly
              assembly {
                  // copy function selector and any arguments
                  calldatacopy(0, 0, calldatasize())
                  // execute function call using the facet
                  let result := delegatecall(gas(), facet, 0, calldatasize(), 0, 0)
                  // get any return value
                  returndatacopy(0, 0, returndatasize())
                  // return any return value or error back to the caller
                  switch result
                  case 0 {
                      revert(0, returndatasize())
                  }
                  default {
                      return(0, returndatasize())
                  }
              }
          }
          // Able to receive ether
          // solhint-disable-next-line no-empty-blocks
          receive() external payable {}
      }
      // SPDX-License-Identifier: MIT
      pragma solidity 0.8.17;
      library LibBytes {
          // solhint-disable no-inline-assembly
          // LibBytes specific errors
          error SliceOverflow();
          error SliceOutOfBounds();
          error AddressOutOfBounds();
          error UintOutOfBounds();
          // -------------------------
          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 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) {
              if (_length + 31 < _length) revert SliceOverflow();
              if (_bytes.length < _start + _length) revert SliceOutOfBounds();
              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) {
              if (_bytes.length < _start + 20) {
                  revert AddressOutOfBounds();
              }
              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) {
              if (_bytes.length < _start + 1) {
                  revert UintOutOfBounds();
              }
              uint8 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0x1), _start))
              }
              return tempUint;
          }
          function toUint16(bytes memory _bytes, uint256 _start) internal pure returns (uint16) {
              if (_bytes.length < _start + 2) {
                  revert UintOutOfBounds();
              }
              uint16 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0x2), _start))
              }
              return tempUint;
          }
          function toUint32(bytes memory _bytes, uint256 _start) internal pure returns (uint32) {
              if (_bytes.length < _start + 4) {
                  revert UintOutOfBounds();
              }
              uint32 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0x4), _start))
              }
              return tempUint;
          }
          function toUint64(bytes memory _bytes, uint256 _start) internal pure returns (uint64) {
              if (_bytes.length < _start + 8) {
                  revert UintOutOfBounds();
              }
              uint64 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0x8), _start))
              }
              return tempUint;
          }
          function toUint96(bytes memory _bytes, uint256 _start) internal pure returns (uint96) {
              if (_bytes.length < _start + 12) {
                  revert UintOutOfBounds();
              }
              uint96 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0xc), _start))
              }
              return tempUint;
          }
          function toUint128(bytes memory _bytes, uint256 _start) internal pure returns (uint128) {
              if (_bytes.length < _start + 16) {
                  revert UintOutOfBounds();
              }
              uint128 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0x10), _start))
              }
              return tempUint;
          }
          function toUint256(bytes memory _bytes, uint256 _start) internal pure returns (uint256) {
              if (_bytes.length < _start + 32) {
                  revert UintOutOfBounds();
              }
              uint256 tempUint;
              assembly {
                  tempUint := mload(add(add(_bytes, 0x20), _start))
              }
              return tempUint;
          }
          function toBytes32(bytes memory _bytes, uint256 _start) internal pure returns (bytes32) {
              if (_bytes.length < _start + 32) {
                  revert UintOutOfBounds();
              }
              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)
                              // solhint-disable-next-line no-empty-blocks
                              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.17;
      import { IDiamondCut } from "../Interfaces/IDiamondCut.sol";
      import { LibUtil } from "../Libraries/LibUtil.sol";
      import { OnlyContractOwner } from "../Errors/GenericErrors.sol";
      /// Implementation of EIP-2535 Diamond Standard
      /// https://eips.ethereum.org/EIPS/eip-2535
      library LibDiamond {
          bytes32 internal constant DIAMOND_STORAGE_POSITION = keccak256("diamond.standard.diamond.storage");
          // Diamond specific errors
          error IncorrectFacetCutAction();
          error NoSelectorsInFace();
          error FunctionAlreadyExists();
          error FacetAddressIsZero();
          error FacetAddressIsNotZero();
          error FacetContainsNoCode();
          error FunctionDoesNotExist();
          error FunctionIsImmutable();
          error InitZeroButCalldataNotEmpty();
          error CalldataEmptyButInitNotZero();
          error InitReverted();
          // ----------------
          struct FacetAddressAndPosition {
              address facetAddress;
              uint96 functionSelectorPosition; // position in facetFunctionSelectors.functionSelectors array
          }
          struct FacetFunctionSelectors {
              bytes4[] functionSelectors;
              uint256 facetAddressPosition; // position of facetAddress in facetAddresses array
          }
          struct DiamondStorage {
              // maps function selector to the facet address and
              // the position of the selector in the facetFunctionSelectors.selectors array
              mapping(bytes4 => FacetAddressAndPosition) selectorToFacetAndPosition;
              // maps facet addresses to function selectors
              mapping(address => FacetFunctionSelectors) facetFunctionSelectors;
              // facet addresses
              address[] facetAddresses;
              // Used to query if a contract implements an interface.
              // Used to implement ERC-165.
              mapping(bytes4 => bool) supportedInterfaces;
              // owner of the contract
              address contractOwner;
          }
          function diamondStorage() internal pure returns (DiamondStorage storage ds) {
              bytes32 position = DIAMOND_STORAGE_POSITION;
              // solhint-disable-next-line no-inline-assembly
              assembly {
                  ds.slot := position
              }
          }
          event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
          function setContractOwner(address _newOwner) internal {
              DiamondStorage storage ds = diamondStorage();
              address previousOwner = ds.contractOwner;
              ds.contractOwner = _newOwner;
              emit OwnershipTransferred(previousOwner, _newOwner);
          }
          function contractOwner() internal view returns (address contractOwner_) {
              contractOwner_ = diamondStorage().contractOwner;
          }
          function enforceIsContractOwner() internal view {
              if (msg.sender != diamondStorage().contractOwner) revert OnlyContractOwner();
          }
          event DiamondCut(IDiamondCut.FacetCut[] _diamondCut, address _init, bytes _calldata);
          // Internal function version of diamondCut
          function diamondCut(
              IDiamondCut.FacetCut[] memory _diamondCut,
              address _init,
              bytes memory _calldata
          ) internal {
              for (uint256 facetIndex; facetIndex < _diamondCut.length; ) {
                  IDiamondCut.FacetCutAction action = _diamondCut[facetIndex].action;
                  if (action == IDiamondCut.FacetCutAction.Add) {
                      addFunctions(_diamondCut[facetIndex].facetAddress, _diamondCut[facetIndex].functionSelectors);
                  } else if (action == IDiamondCut.FacetCutAction.Replace) {
                      replaceFunctions(_diamondCut[facetIndex].facetAddress, _diamondCut[facetIndex].functionSelectors);
                  } else if (action == IDiamondCut.FacetCutAction.Remove) {
                      removeFunctions(_diamondCut[facetIndex].facetAddress, _diamondCut[facetIndex].functionSelectors);
                  } else {
                      revert IncorrectFacetCutAction();
                  }
                  unchecked {
                      ++facetIndex;
                  }
              }
              emit DiamondCut(_diamondCut, _init, _calldata);
              initializeDiamondCut(_init, _calldata);
          }
          function addFunctions(address _facetAddress, bytes4[] memory _functionSelectors) internal {
              if (_functionSelectors.length == 0) {
                  revert NoSelectorsInFace();
              }
              DiamondStorage storage ds = diamondStorage();
              if (LibUtil.isZeroAddress(_facetAddress)) {
                  revert FacetAddressIsZero();
              }
              uint96 selectorPosition = uint96(ds.facetFunctionSelectors[_facetAddress].functionSelectors.length);
              // add new facet address if it does not exist
              if (selectorPosition == 0) {
                  addFacet(ds, _facetAddress);
              }
              for (uint256 selectorIndex; selectorIndex < _functionSelectors.length; ) {
                  bytes4 selector = _functionSelectors[selectorIndex];
                  address oldFacetAddress = ds.selectorToFacetAndPosition[selector].facetAddress;
                  if (!LibUtil.isZeroAddress(oldFacetAddress)) {
                      revert FunctionAlreadyExists();
                  }
                  addFunction(ds, selector, selectorPosition, _facetAddress);
                  unchecked {
                      ++selectorPosition;
                      ++selectorIndex;
                  }
              }
          }
          function replaceFunctions(address _facetAddress, bytes4[] memory _functionSelectors) internal {
              if (_functionSelectors.length == 0) {
                  revert NoSelectorsInFace();
              }
              DiamondStorage storage ds = diamondStorage();
              if (LibUtil.isZeroAddress(_facetAddress)) {
                  revert FacetAddressIsZero();
              }
              uint96 selectorPosition = uint96(ds.facetFunctionSelectors[_facetAddress].functionSelectors.length);
              // add new facet address if it does not exist
              if (selectorPosition == 0) {
                  addFacet(ds, _facetAddress);
              }
              for (uint256 selectorIndex; selectorIndex < _functionSelectors.length; ) {
                  bytes4 selector = _functionSelectors[selectorIndex];
                  address oldFacetAddress = ds.selectorToFacetAndPosition[selector].facetAddress;
                  if (oldFacetAddress == _facetAddress) {
                      revert FunctionAlreadyExists();
                  }
                  removeFunction(ds, oldFacetAddress, selector);
                  addFunction(ds, selector, selectorPosition, _facetAddress);
                  unchecked {
                      ++selectorPosition;
                      ++selectorIndex;
                  }
              }
          }
          function removeFunctions(address _facetAddress, bytes4[] memory _functionSelectors) internal {
              if (_functionSelectors.length == 0) {
                  revert NoSelectorsInFace();
              }
              DiamondStorage storage ds = diamondStorage();
              // if function does not exist then do nothing and return
              if (!LibUtil.isZeroAddress(_facetAddress)) {
                  revert FacetAddressIsNotZero();
              }
              for (uint256 selectorIndex; selectorIndex < _functionSelectors.length; ) {
                  bytes4 selector = _functionSelectors[selectorIndex];
                  address oldFacetAddress = ds.selectorToFacetAndPosition[selector].facetAddress;
                  removeFunction(ds, oldFacetAddress, selector);
                  unchecked {
                      ++selectorIndex;
                  }
              }
          }
          function addFacet(DiamondStorage storage ds, address _facetAddress) internal {
              enforceHasContractCode(_facetAddress);
              ds.facetFunctionSelectors[_facetAddress].facetAddressPosition = ds.facetAddresses.length;
              ds.facetAddresses.push(_facetAddress);
          }
          function addFunction(
              DiamondStorage storage ds,
              bytes4 _selector,
              uint96 _selectorPosition,
              address _facetAddress
          ) internal {
              ds.selectorToFacetAndPosition[_selector].functionSelectorPosition = _selectorPosition;
              ds.facetFunctionSelectors[_facetAddress].functionSelectors.push(_selector);
              ds.selectorToFacetAndPosition[_selector].facetAddress = _facetAddress;
          }
          function removeFunction(
              DiamondStorage storage ds,
              address _facetAddress,
              bytes4 _selector
          ) internal {
              if (LibUtil.isZeroAddress(_facetAddress)) {
                  revert FunctionDoesNotExist();
              }
              // an immutable function is a function defined directly in a diamond
              if (_facetAddress == address(this)) {
                  revert FunctionIsImmutable();
              }
              // replace selector with last selector, then delete last selector
              uint256 selectorPosition = ds.selectorToFacetAndPosition[_selector].functionSelectorPosition;
              uint256 lastSelectorPosition = ds.facetFunctionSelectors[_facetAddress].functionSelectors.length - 1;
              // if not the same then replace _selector with lastSelector
              if (selectorPosition != lastSelectorPosition) {
                  bytes4 lastSelector = ds.facetFunctionSelectors[_facetAddress].functionSelectors[lastSelectorPosition];
                  ds.facetFunctionSelectors[_facetAddress].functionSelectors[selectorPosition] = lastSelector;
                  ds.selectorToFacetAndPosition[lastSelector].functionSelectorPosition = uint96(selectorPosition);
              }
              // delete the last selector
              ds.facetFunctionSelectors[_facetAddress].functionSelectors.pop();
              delete ds.selectorToFacetAndPosition[_selector];
              // if no more selectors for facet address then delete the facet address
              if (lastSelectorPosition == 0) {
                  // replace facet address with last facet address and delete last facet address
                  uint256 lastFacetAddressPosition = ds.facetAddresses.length - 1;
                  uint256 facetAddressPosition = ds.facetFunctionSelectors[_facetAddress].facetAddressPosition;
                  if (facetAddressPosition != lastFacetAddressPosition) {
                      address lastFacetAddress = ds.facetAddresses[lastFacetAddressPosition];
                      ds.facetAddresses[facetAddressPosition] = lastFacetAddress;
                      ds.facetFunctionSelectors[lastFacetAddress].facetAddressPosition = facetAddressPosition;
                  }
                  ds.facetAddresses.pop();
                  delete ds.facetFunctionSelectors[_facetAddress].facetAddressPosition;
              }
          }
          function initializeDiamondCut(address _init, bytes memory _calldata) internal {
              if (LibUtil.isZeroAddress(_init)) {
                  if (_calldata.length != 0) {
                      revert InitZeroButCalldataNotEmpty();
                  }
              } else {
                  if (_calldata.length == 0) {
                      revert CalldataEmptyButInitNotZero();
                  }
                  if (_init != address(this)) {
                      enforceHasContractCode(_init);
                  }
                  // solhint-disable-next-line avoid-low-level-calls
                  (bool success, bytes memory error) = _init.delegatecall(_calldata);
                  if (!success) {
                      if (error.length > 0) {
                          // bubble up the error
                          revert(string(error));
                      } else {
                          revert InitReverted();
                      }
                  }
              }
          }
          function enforceHasContractCode(address _contract) internal view {
              uint256 contractSize;
              // solhint-disable-next-line no-inline-assembly
              assembly {
                  contractSize := extcodesize(_contract)
              }
              if (contractSize == 0) {
                  revert FacetContainsNoCode();
              }
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity 0.8.17;
      import "./LibBytes.sol";
      library LibUtil {
          using LibBytes for bytes;
          function getRevertMsg(bytes memory _res) internal pure returns (string memory) {
              // If the _res length is less than 68, then the transaction failed silently (without a revert message)
              if (_res.length < 68) return "Transaction reverted silently";
              bytes memory revertData = _res.slice(4, _res.length - 4); // Remove the selector which is the first 4 bytes
              return abi.decode(revertData, (string)); // All that remains is the revert string
          }
          /// @notice Determines whether the given address is the zero address
          /// @param addr The address to verify
          /// @return Boolean indicating if the address is the zero address
          function isZeroAddress(address addr) internal pure returns (bool) {
              return addr == address(0);
          }
      }
      

      File 2 of 3: GasZipV2
      // SPDX-License-Identifier: GPL-3.0
      pragma solidity ^0.8.17;
      contract GasZipV2 {
          event Deposit(address from, uint256 chains, uint256 amount, bytes32 to);
          
          address public owner;
          constructor(address _owner) {
              owner = _owner;
          }
          function deposit(uint256 chains, bytes32 to) payable external {
              require(msg.value != 0, "No Value");
              emit Deposit(msg.sender, chains, msg.value, to);
          }
          function deposit(uint256 chains, address to) payable external {
              require(msg.value != 0, "No Value");
              emit Deposit(msg.sender, chains, msg.value, bytes32(bytes20(uint160(to))));
          }
          function withdraw(address token) external {
              require(msg.sender == owner);
              if (token == address(0)) {
                  owner.call{value: address(this).balance}("");
              } else {
                  IERC20(token).transfer(owner, IERC20(token).balanceOf(address(this)));
              }
          }
          function newOwner(address _owner) external {
              require(msg.sender == owner);
              owner = _owner;
          }
      }
      interface IERC20 {
          function balanceOf(address) external view returns (uint256);
          function transfer(address, uint256) external returns (bool);
      }

      File 3 of 3: GasZipFacet
      // SPDX-License-Identifier: LGPL-3.0-only
      pragma solidity ^0.8.17;
      import { ILiFi } from "../Interfaces/ILiFi.sol";
      import { IGasZip } from "../Interfaces/IGasZip.sol";
      import { LibSwap } from "../Libraries/LibSwap.sol";
      import { LibAsset } from "../Libraries/LibAsset.sol";
      import { ReentrancyGuard } from "../Helpers/ReentrancyGuard.sol";
      import { SwapperV2 } from "../Helpers/SwapperV2.sol";
      import { Validatable } from "../Helpers/Validatable.sol";
      import { SafeTransferLib } from "solady/utils/SafeTransferLib.sol";
      import { InvalidCallData, CannotBridgeToSameNetwork, InvalidAmount, InvalidConfig } from "lifi/Errors/GenericErrors.sol";
      /// @title GasZipFacet
      /// @author LI.FI (https://li.fi)
      /// @notice Provides functionality to swap ERC20 tokens to native and deposit them to the gas.zip protocol (https://www.gas.zip/)
      /// @custom:version 2.0.4
      contract GasZipFacet is ILiFi, ReentrancyGuard, SwapperV2, Validatable {
          using SafeTransferLib for address;
          error OnlyNativeAllowed();
          error TooManyChainIds();
          /// State ///
          address public constant NON_EVM_ADDRESS =
              0x11f111f111f111F111f111f111F111f111f111F1;
          IGasZip public immutable GAS_ZIP_ROUTER;
          uint256 internal constant MAX_CHAINID_LENGTH_ALLOWED = 16;
          /// Constructor ///
          constructor(address _gasZipRouter) {
              if (address(_gasZipRouter) == address(0)) {
                  revert InvalidConfig();
              }
              GAS_ZIP_ROUTER = IGasZip(_gasZipRouter);
          }
          /// @notice Bridges tokens using the gas.zip protocol
          /// @dev this function only supports native flow. For ERC20 flows this facet should be used as a protocol step instead
          /// @param _bridgeData The core information needed for bridging
          /// @param _gasZipData contains information which chains and address gas should be sent to
          function startBridgeTokensViaGasZip(
              ILiFi.BridgeData memory _bridgeData,
              IGasZip.GasZipData calldata _gasZipData
          )
              external
              payable
              nonReentrant
              doesNotContainSourceSwaps(_bridgeData)
              doesNotContainDestinationCalls(_bridgeData)
          {
              // this function / path shall only be used for native assets
              if (!LibAsset.isNativeAsset(_bridgeData.sendingAssetId))
                  revert OnlyNativeAllowed();
              // make sure that msg.value matches the to-be-deposited amount
              if (msg.value != _bridgeData.minAmount) revert InvalidAmount();
              // deposit native to Gas.zip
              _startBridge(_bridgeData, _gasZipData);
          }
          /// @notice Performs one or multiple actions (e.g. fee collection, swapping) that must end with the native token before depositing to the gas.zip protocol
          /// @param _bridgeData The core information needed for depositing
          /// @param _swapData An array of swap related data for performing swaps before bridging
          /// @param _gasZipData contains information which chains and address gas should be sent to
          function swapAndStartBridgeTokensViaGasZip(
              ILiFi.BridgeData memory _bridgeData,
              LibSwap.SwapData[] calldata _swapData,
              IGasZip.GasZipData calldata _gasZipData
          )
              external
              payable
              nonReentrant
              refundExcessNative(payable(msg.sender))
              containsSourceSwaps(_bridgeData)
              doesNotContainDestinationCalls(_bridgeData)
          {
              // make sure that the output of the last swap step is native
              if (
                  !LibAsset.isNativeAsset(
                      _swapData[_swapData.length - 1].receivingAssetId
                  )
              ) revert InvalidCallData();
              // deposit and swap ERC20 tokens to native
              _bridgeData.minAmount = _depositAndSwap(
                  _bridgeData.transactionId,
                  _bridgeData.minAmount,
                  _swapData,
                  payable(msg.sender)
              );
              // deposit native to Gas.zip
              _startBridge(_bridgeData, _gasZipData);
          }
          /// @dev Contains the business logic for depositing to GasZip protocol
          /// @param _bridgeData The core information needed for bridging
          /// @param _gasZipData contains information which chains and address gas should be sent to
          function _startBridge(
              ILiFi.BridgeData memory _bridgeData,
              IGasZip.GasZipData calldata _gasZipData
          ) internal {
              // make sure receiver address has a value to prevent potential loss of funds
              if (_gasZipData.receiverAddress == bytes32(0))
                  revert InvalidCallData();
              // validate that receiverAddress matches with bridgeData in case of EVM target chain
              if (
                  _bridgeData.receiver != NON_EVM_ADDRESS &&
                  _gasZipData.receiverAddress !=
                  bytes32(bytes20(uint160(_bridgeData.receiver))) // GasZip expects the receiver address as a right-padded bytes32 value. That's why we use bytes20 instead of uint256 to ensure proper formatting
              ) revert InvalidCallData();
              // validate bridgeData
              // make sure destinationChainId is of a different network
              if (_bridgeData.destinationChainId == block.chainid)
                  revert CannotBridgeToSameNetwork();
              // We are depositing to a new contract that supports deposits for EVM chains + Solana (therefore 'receiver' address is bytes32)
              GAS_ZIP_ROUTER.deposit{ value: _bridgeData.minAmount }(
                  _gasZipData.destinationChains,
                  _gasZipData.receiverAddress
              );
              emit LiFiTransferStarted(_bridgeData);
          }
          /// @dev Returns a value that signals to Gas.zip to which chains gas should be sent in equal parts
          /// @param _chainIds a list of Gas.zip-specific chainIds (not the original chainIds), see https://dev.gas.zip/gas/chain-support/outbound
          function getDestinationChainsValue(
              uint8[] calldata _chainIds
          ) external pure returns (uint256 destinationChains) {
              uint256 length = _chainIds.length;
              if (length > MAX_CHAINID_LENGTH_ALLOWED) revert TooManyChainIds();
              for (uint256 i; i < length; ++i) {
                  // Shift destinationChains left by 16 bits and add the next chainID
                  destinationChains =
                      (destinationChains << 16) |
                      uint256(_chainIds[i]);
              }
          }
      }
      // SPDX-License-Identifier: LGPL-3.0-only
      pragma solidity ^0.8.17;
      /// @title LIFI Interface
      /// @author LI.FI (https://li.fi)
      /// @custom:version 1.0.0
      interface ILiFi {
          /// Structs ///
          struct BridgeData {
              bytes32 transactionId;
              string bridge;
              string integrator;
              address referrer;
              address sendingAssetId;
              address receiver;
              uint256 minAmount;
              uint256 destinationChainId;
              bool hasSourceSwaps;
              bool hasDestinationCall;
          }
          /// Events ///
          event LiFiTransferStarted(ILiFi.BridgeData bridgeData);
          event LiFiTransferCompleted(
              bytes32 indexed transactionId,
              address receivingAssetId,
              address receiver,
              uint256 amount,
              uint256 timestamp
          );
          event LiFiTransferRecovered(
              bytes32 indexed transactionId,
              address receivingAssetId,
              address receiver,
              uint256 amount,
              uint256 timestamp
          );
          event LiFiGenericSwapCompleted(
              bytes32 indexed transactionId,
              string integrator,
              string referrer,
              address receiver,
              address fromAssetId,
              address toAssetId,
              uint256 fromAmount,
              uint256 toAmount
          );
          // Deprecated but kept here to include in ABI to parse historic events
          event LiFiSwappedGeneric(
              bytes32 indexed transactionId,
              string integrator,
              string referrer,
              address fromAssetId,
              address toAssetId,
              uint256 fromAmount,
              uint256 toAmount
          );
      }
      // SPDX-License-Identifier: LGPL-3.0-only
      pragma solidity ^0.8.17;
      /// @title Interface for GasZip
      /// @author LI.FI (https://li.fi)
      /// @custom:version 1.0.0
      interface IGasZip {
          /// @dev GasZip-specific bridge data
          /// @param receiverAddress the address on destination chain(s) where gas should be sent to
          /// @param destinationChains a value that represents a list of chains to which gas should be distributed (see https://dev.gas.zip/gas/code-examples/deposit for more details)
          struct GasZipData {
              bytes32 receiverAddress;
              // EVM addresses need to be padded with trailing 0s, e.g.:
              // 0x391E7C679D29BD940D63BE94AD22A25D25B5A604000000000000000000000000 (correct)
              // 0x000000000000000000000000391E7C679D29BD940D63BE94AD22A25D25B5A604 (incorrect)
              uint256 destinationChains;
          }
          function deposit(uint256 destinationChains, bytes32 to) external payable;
      }
      // SPDX-License-Identifier: LGPL-3.0-only
      pragma solidity ^0.8.17;
      import { LibAsset } from "./LibAsset.sol";
      import { LibUtil } from "./LibUtil.sol";
      import { InvalidContract, NoSwapFromZeroBalance } from "../Errors/GenericErrors.sol";
      import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
      /// @title LibSwap
      /// @custom:version 1.1.0
      /// @notice This library contains functionality to execute mostly swaps but also
      ///         other calls such as fee collection, token wrapping/unwrapping or
      ///         sending gas to destination chain
      library LibSwap {
          /// @notice Struct containing all necessary data to execute a swap or generic call
          /// @param callTo The address of the contract to call for executing the swap
          /// @param approveTo The address that will receive token approval (can be different than callTo for some DEXs)
          /// @param sendingAssetId The address of the token being sent
          /// @param receivingAssetId The address of the token expected to be received
          /// @param fromAmount The exact amount of the sending asset to be used in the call
          /// @param callData Encoded function call data to be sent to the `callTo` contract
          /// @param requiresDeposit A flag indicating whether the tokens must be deposited (pulled) before the call
          struct SwapData {
              address callTo;
              address approveTo;
              address sendingAssetId;
              address receivingAssetId;
              uint256 fromAmount;
              bytes callData;
              bool requiresDeposit;
          }
          /// @notice Emitted after a successful asset swap or related operation
          /// @param transactionId    The unique identifier associated with the swap operation
          /// @param dex              The address of the DEX or contract that handled the swap
          /// @param fromAssetId      The address of the token that was sent
          /// @param toAssetId        The address of the token that was received
          /// @param fromAmount       The amount of `fromAssetId` sent
          /// @param toAmount         The amount of `toAssetId` received
          /// @param timestamp        The timestamp when the swap was executed
          event AssetSwapped(
              bytes32 transactionId,
              address dex,
              address fromAssetId,
              address toAssetId,
              uint256 fromAmount,
              uint256 toAmount,
              uint256 timestamp
          );
          function swap(bytes32 transactionId, SwapData calldata _swap) internal {
              // make sure callTo is a contract
              if (!LibAsset.isContract(_swap.callTo)) revert InvalidContract();
              // make sure that fromAmount is not 0
              uint256 fromAmount = _swap.fromAmount;
              if (fromAmount == 0) revert NoSwapFromZeroBalance();
              // determine how much native value to send with the swap call
              uint256 nativeValue = LibAsset.isNativeAsset(_swap.sendingAssetId)
                  ? _swap.fromAmount
                  : 0;
              // store initial balance (required for event emission)
              uint256 initialReceivingAssetBalance = LibAsset.getOwnBalance(
                  _swap.receivingAssetId
              );
              // max approve (if ERC20)
              if (nativeValue == 0) {
                  LibAsset.maxApproveERC20(
                      IERC20(_swap.sendingAssetId),
                      _swap.approveTo,
                      _swap.fromAmount
                  );
              }
              // we used to have a sending asset balance check here (initialSendingAssetBalance >= _swap.fromAmount)
              // this check was removed to allow for more flexibility with rebasing/fee-taking tokens
              // the general assumption is that if not enough tokens are available to execute the calldata, the transaction will fail anyway
              // the error message might not be as explicit though
              // execute the swap
              // solhint-disable-next-line avoid-low-level-calls
              (bool success, bytes memory res) = _swap.callTo.call{
                  value: nativeValue
              }(_swap.callData);
              if (!success) {
                  LibUtil.revertWith(res);
              }
              // get post-swap balance
              uint256 newBalance = LibAsset.getOwnBalance(_swap.receivingAssetId);
              // emit event
              emit AssetSwapped(
                  transactionId,
                  _swap.callTo,
                  _swap.sendingAssetId,
                  _swap.receivingAssetId,
                  _swap.fromAmount,
                  newBalance > initialReceivingAssetBalance
                      ? newBalance - initialReceivingAssetBalance
                      : newBalance,
                  block.timestamp
              );
          }
      }
      // SPDX-License-Identifier: UNLICENSED
      pragma solidity ^0.8.17;
      import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
      import { LibSwap } from "./LibSwap.sol";
      import { SafeTransferLib } from "solady/utils/SafeTransferLib.sol";
      import { InvalidReceiver, NullAddrIsNotAValidSpender, InvalidAmount, NullAddrIsNotAnERC20Token } from "../Errors/GenericErrors.sol";
      /// @title LibAsset
      /// @custom:version 2.1.0
      /// @notice This library contains helpers for dealing with onchain transfers
      ///         of assets, including accounting for the native asset `assetId`
      ///         conventions and any noncompliant ERC20 transfers
      library LibAsset {
          using SafeTransferLib for address;
          using SafeTransferLib for address payable;
          address internal constant NULL_ADDRESS = address(0);
          address internal constant NON_EVM_ADDRESS =
              0x11f111f111f111F111f111f111F111f111f111F1;
          /// @dev All native assets use the empty address for their asset id
          ///      by convention
          address internal constant NATIVE_ASSETID = NULL_ADDRESS;
          /// @dev EIP-7702 delegation designator prefix for Account Abstraction
          bytes3 internal constant DELEGATION_DESIGNATOR = 0xef0100;
          /// @notice Gets the balance of the inheriting contract for the given asset
          /// @param assetId The asset identifier to get the balance of
          /// @return Balance held by contracts using this library (returns 0 if assetId does not exist)
          function getOwnBalance(address assetId) internal view returns (uint256) {
              return
                  isNativeAsset(assetId)
                      ? address(this).balance
                      : assetId.balanceOf(address(this));
          }
          /// @notice Wrapper function to transfer a given asset (native or erc20) to
          ///         some recipient. Should handle all non-compliant return value
          ///         tokens as well by using the SafeERC20 contract by open zeppelin.
          /// @param assetId Asset id for transfer (address(0) for native asset,
          ///                token address for erc20s)
          /// @param recipient Address to send asset to
          /// @param amount Amount to send to given recipient
          function transferAsset(
              address assetId,
              address payable recipient,
              uint256 amount
          ) internal {
              if (isNativeAsset(assetId)) {
                  transferNativeAsset(recipient, amount);
              } else {
                  transferERC20(assetId, recipient, amount);
              }
          }
          /// @notice Transfers ether from the inheriting contract to a given
          ///         recipient
          /// @param recipient Address to send ether to
          /// @param amount Amount to send to given recipient
          function transferNativeAsset(
              address payable recipient,
              uint256 amount
          ) private {
              // make sure a meaningful receiver address was provided
              if (recipient == NULL_ADDRESS) revert InvalidReceiver();
              // transfer native asset (will revert if target reverts or contract has insufficient balance)
              recipient.safeTransferETH(amount);
          }
          /// @notice Transfers tokens from the inheriting contract to a given recipient
          /// @param assetId Token address to transfer
          /// @param recipient Address to send tokens to
          /// @param amount Amount to send to given recipient
          function transferERC20(
              address assetId,
              address recipient,
              uint256 amount
          ) private {
              // make sure a meaningful receiver address was provided
              if (recipient == NULL_ADDRESS) {
                  revert InvalidReceiver();
              }
              // transfer ERC20 assets (will revert if target reverts or contract has insufficient balance)
              assetId.safeTransfer(recipient, amount);
          }
          /// @notice Transfers tokens from a sender to a given recipient
          /// @param assetId Token address to transfer
          /// @param from Address of sender/owner
          /// @param recipient Address of recipient/spender
          /// @param amount Amount to transfer from owner to spender
          function transferFromERC20(
              address assetId,
              address from,
              address recipient,
              uint256 amount
          ) internal {
              // check if native asset
              if (isNativeAsset(assetId)) {
                  revert NullAddrIsNotAnERC20Token();
              }
              // make sure a meaningful receiver address was provided
              if (recipient == NULL_ADDRESS) {
                  revert InvalidReceiver();
              }
              // transfer ERC20 assets (will revert if target reverts or contract has insufficient balance)
              assetId.safeTransferFrom(from, recipient, amount);
          }
          /// @notice Pulls tokens from msg.sender
          /// @param assetId Token address to transfer
          /// @param amount Amount to transfer from owner
          function depositAsset(address assetId, uint256 amount) internal {
              // make sure a meaningful amount was provided
              if (amount == 0) revert InvalidAmount();
              // check if native asset
              if (isNativeAsset(assetId)) {
                  // ensure msg.value is equal or greater than amount
                  if (msg.value < amount) revert InvalidAmount();
              } else {
                  // transfer ERC20 assets (will revert if target reverts or contract has insufficient balance)
                  assetId.safeTransferFrom(msg.sender, address(this), amount);
              }
          }
          function depositAssets(LibSwap.SwapData[] calldata swaps) internal {
              for (uint256 i = 0; i < swaps.length; ) {
                  LibSwap.SwapData calldata swap = swaps[i];
                  if (swap.requiresDeposit) {
                      depositAsset(swap.sendingAssetId, swap.fromAmount);
                  }
                  unchecked {
                      i++;
                  }
              }
          }
          /// @notice If the current allowance is insufficient, the allowance for a given spender
          ///         is set to MAX_UINT.
          /// @param assetId Token address to transfer
          /// @param spender Address to give spend approval to
          /// @param amount allowance amount required for current transaction
          function maxApproveERC20(
              IERC20 assetId,
              address spender,
              uint256 amount
          ) internal {
              approveERC20(assetId, spender, amount, type(uint256).max);
          }
          /// @notice If the current allowance is insufficient, the allowance for a given spender
          ///         is set to the amount provided
          /// @param assetId Token address to transfer
          /// @param spender Address to give spend approval to
          /// @param requiredAllowance Allowance required for current transaction
          /// @param setAllowanceTo The amount the allowance should be set to if current allowance is insufficient
          function approveERC20(
              IERC20 assetId,
              address spender,
              uint256 requiredAllowance,
              uint256 setAllowanceTo
          ) internal {
              if (isNativeAsset(address(assetId))) {
                  return;
              }
              // make sure a meaningful spender address was provided
              if (spender == NULL_ADDRESS) {
                  revert NullAddrIsNotAValidSpender();
              }
              // check if allowance is sufficient, otherwise set allowance to provided amount
              // If the initial attempt to approve fails, attempts to reset the approved amount to zero,
              // then retries the approval again (some tokens, e.g. USDT, requires this).
              // Reverts upon failure
              if (assetId.allowance(address(this), spender) < requiredAllowance) {
                  address(assetId).safeApproveWithRetry(spender, setAllowanceTo);
              }
          }
          /// @notice Determines whether the given assetId is the native asset
          /// @param assetId The asset identifier to evaluate
          /// @return Boolean indicating if the asset is the native asset
          function isNativeAsset(address assetId) internal pure returns (bool) {
              return assetId == NATIVE_ASSETID;
          }
          /// @notice Checks if the given address is a contract
          ///         Returns true for any account with runtime code (excluding EIP-7702 accounts).
          ///         For EIP-7702 accounts, checks if code size is exactly 23 bytes (delegation format).
          ///         Limitations:
          ///         - Cannot distinguish between EOA and self-destructed contract
          /// @param account The address to be checked
          function isContract(address account) internal view returns (bool) {
              uint256 size;
              assembly {
                  size := extcodesize(account)
              }
              // Return true only for regular contracts (size > 23)
              // EIP-7702 delegated accounts (size == 23) are still EOAs, not contracts
              return size > 23;
          }
      }
      // SPDX-License-Identifier: UNLICENSED
      /// @custom:version 1.0.0
      pragma solidity ^0.8.17;
      /// @title Reentrancy Guard
      /// @author LI.FI (https://li.fi)
      /// @notice Abstract contract to provide protection against reentrancy
      abstract contract ReentrancyGuard {
          /// Storage ///
          bytes32 private constant NAMESPACE = keccak256("com.lifi.reentrancyguard");
          /// Types ///
          struct ReentrancyStorage {
              uint256 status;
          }
          /// Errors ///
          error ReentrancyError();
          /// Constants ///
          uint256 private constant _NOT_ENTERED = 0;
          uint256 private constant _ENTERED = 1;
          /// Modifiers ///
          modifier nonReentrant() {
              ReentrancyStorage storage s = reentrancyStorage();
              if (s.status == _ENTERED) revert ReentrancyError();
              s.status = _ENTERED;
              _;
              s.status = _NOT_ENTERED;
          }
          /// Private Methods ///
          /// @dev fetch local storage
          function reentrancyStorage()
              private
              pure
              returns (ReentrancyStorage storage data)
          {
              bytes32 position = NAMESPACE;
              // solhint-disable-next-line no-inline-assembly
              assembly {
                  data.slot := position
              }
          }
      }
      // SPDX-License-Identifier: LGPL-3.0-only
      /// @custom:version 1.0.0
      pragma solidity ^0.8.17;
      import { ILiFi } from "../Interfaces/ILiFi.sol";
      import { LibSwap } from "../Libraries/LibSwap.sol";
      import { LibAsset } from "../Libraries/LibAsset.sol";
      import { LibAllowList } from "../Libraries/LibAllowList.sol";
      import { ContractCallNotAllowed, NoSwapDataProvided, CumulativeSlippageTooHigh } from "../Errors/GenericErrors.sol";
      /// @title Swapper
      /// @author LI.FI (https://li.fi)
      /// @notice Abstract contract to provide swap functionality
      contract SwapperV2 is ILiFi {
          /// Types ///
          /// @dev only used to get around "Stack Too Deep" errors
          struct ReserveData {
              bytes32 transactionId;
              address payable leftoverReceiver;
              uint256 nativeReserve;
          }
          /// Modifiers ///
          /// @dev Sends any leftover balances back to the user
          /// @notice Sends any leftover balances to the user
          /// @param _swaps Swap data array
          /// @param _leftoverReceiver Address to send leftover tokens to
          /// @param _initialBalances Array of initial token balances
          modifier noLeftovers(
              LibSwap.SwapData[] calldata _swaps,
              address payable _leftoverReceiver,
              uint256[] memory _initialBalances
          ) {
              uint256 numSwaps = _swaps.length;
              if (numSwaps != 1) {
                  address finalAsset = _swaps[numSwaps - 1].receivingAssetId;
                  uint256 curBalance;
                  _;
                  for (uint256 i = 0; i < numSwaps - 1; ) {
                      address curAsset = _swaps[i].receivingAssetId;
                      // Handle multi-to-one swaps
                      if (curAsset != finalAsset) {
                          curBalance =
                              LibAsset.getOwnBalance(curAsset) -
                              _initialBalances[i];
                          if (curBalance > 0) {
                              LibAsset.transferAsset(
                                  curAsset,
                                  _leftoverReceiver,
                                  curBalance
                              );
                          }
                      }
                      unchecked {
                          ++i;
                      }
                  }
              } else {
                  _;
              }
          }
          /// @dev Sends any leftover balances back to the user reserving native tokens
          /// @notice Sends any leftover balances to the user
          /// @param _swaps Swap data array
          /// @param _leftoverReceiver Address to send leftover tokens to
          /// @param _initialBalances Array of initial token balances
          modifier noLeftoversReserve(
              LibSwap.SwapData[] calldata _swaps,
              address payable _leftoverReceiver,
              uint256[] memory _initialBalances,
              uint256 _nativeReserve
          ) {
              uint256 numSwaps = _swaps.length;
              if (numSwaps != 1) {
                  address finalAsset = _swaps[numSwaps - 1].receivingAssetId;
                  uint256 curBalance;
                  _;
                  for (uint256 i = 0; i < numSwaps - 1; ) {
                      address curAsset = _swaps[i].receivingAssetId;
                      // Handle multi-to-one swaps
                      if (curAsset != finalAsset) {
                          curBalance =
                              LibAsset.getOwnBalance(curAsset) -
                              _initialBalances[i];
                          uint256 reserve = LibAsset.isNativeAsset(curAsset)
                              ? _nativeReserve
                              : 0;
                          if (curBalance > 0) {
                              LibAsset.transferAsset(
                                  curAsset,
                                  _leftoverReceiver,
                                  curBalance - reserve
                              );
                          }
                      }
                      unchecked {
                          ++i;
                      }
                  }
              } else {
                  _;
              }
          }
          /// @dev Refunds any excess native asset sent to the contract after the main function
          /// @notice Refunds any excess native asset sent to the contract after the main function
          /// @param _refundReceiver Address to send refunds to
          modifier refundExcessNative(address payable _refundReceiver) {
              uint256 initialBalance = address(this).balance - msg.value;
              _;
              uint256 finalBalance = address(this).balance;
              if (finalBalance > initialBalance) {
                  LibAsset.transferAsset(
                      LibAsset.NATIVE_ASSETID,
                      _refundReceiver,
                      finalBalance - initialBalance
                  );
              }
          }
          /// Internal Methods ///
          /// @dev Deposits value, executes swaps, and performs minimum amount check
          /// @param _transactionId the transaction id associated with the operation
          /// @param _minAmount the minimum amount of the final asset to receive
          /// @param _swaps Array of data used to execute swaps
          /// @param _leftoverReceiver The address to send leftover funds to
          /// @return uint256 result of the swap
          function _depositAndSwap(
              bytes32 _transactionId,
              uint256 _minAmount,
              LibSwap.SwapData[] calldata _swaps,
              address payable _leftoverReceiver
          ) internal returns (uint256) {
              uint256 numSwaps = _swaps.length;
              if (numSwaps == 0) {
                  revert NoSwapDataProvided();
              }
              address finalTokenId = _swaps[numSwaps - 1].receivingAssetId;
              uint256 initialBalance = LibAsset.getOwnBalance(finalTokenId);
              if (LibAsset.isNativeAsset(finalTokenId)) {
                  initialBalance -= msg.value;
              }
              uint256[] memory initialBalances = _fetchBalances(_swaps);
              LibAsset.depositAssets(_swaps);
              _executeSwaps(
                  _transactionId,
                  _swaps,
                  _leftoverReceiver,
                  initialBalances
              );
              uint256 newBalance = LibAsset.getOwnBalance(finalTokenId) -
                  initialBalance;
              if (newBalance < _minAmount) {
                  revert CumulativeSlippageTooHigh(_minAmount, newBalance);
              }
              return newBalance;
          }
          /// @dev Deposits value, executes swaps, and performs minimum amount check and reserves native token for fees
          /// @param _transactionId the transaction id associated with the operation
          /// @param _minAmount the minimum amount of the final asset to receive
          /// @param _swaps Array of data used to execute swaps
          /// @param _leftoverReceiver The address to send leftover funds to
          /// @param _nativeReserve Amount of native token to prevent from being swept back to the caller
          function _depositAndSwap(
              bytes32 _transactionId,
              uint256 _minAmount,
              LibSwap.SwapData[] calldata _swaps,
              address payable _leftoverReceiver,
              uint256 _nativeReserve
          ) internal returns (uint256) {
              uint256 numSwaps = _swaps.length;
              if (numSwaps == 0) {
                  revert NoSwapDataProvided();
              }
              address finalTokenId = _swaps[numSwaps - 1].receivingAssetId;
              uint256 initialBalance = LibAsset.getOwnBalance(finalTokenId);
              if (LibAsset.isNativeAsset(finalTokenId)) {
                  initialBalance -= msg.value;
              }
              uint256[] memory initialBalances = _fetchBalances(_swaps);
              LibAsset.depositAssets(_swaps);
              ReserveData memory rd = ReserveData(
                  _transactionId,
                  _leftoverReceiver,
                  _nativeReserve
              );
              _executeSwaps(rd, _swaps, initialBalances);
              uint256 newBalance = LibAsset.getOwnBalance(finalTokenId) -
                  initialBalance;
              if (LibAsset.isNativeAsset(finalTokenId)) {
                  newBalance -= _nativeReserve;
              }
              if (newBalance < _minAmount) {
                  revert CumulativeSlippageTooHigh(_minAmount, newBalance);
              }
              return newBalance;
          }
          /// Private Methods ///
          /// @dev Executes swaps and checks that DEXs used are in the allowList
          /// @param _transactionId the transaction id associated with the operation
          /// @param _swaps Array of data used to execute swaps
          /// @param _leftoverReceiver Address to send leftover tokens to
          /// @param _initialBalances Array of initial balances
          function _executeSwaps(
              bytes32 _transactionId,
              LibSwap.SwapData[] calldata _swaps,
              address payable _leftoverReceiver,
              uint256[] memory _initialBalances
          ) internal noLeftovers(_swaps, _leftoverReceiver, _initialBalances) {
              uint256 numSwaps = _swaps.length;
              for (uint256 i = 0; i < numSwaps; ) {
                  LibSwap.SwapData calldata currentSwap = _swaps[i];
                  if (
                      !((LibAsset.isNativeAsset(currentSwap.sendingAssetId) ||
                          LibAllowList.contractIsAllowed(currentSwap.approveTo)) &&
                          LibAllowList.contractIsAllowed(currentSwap.callTo) &&
                          LibAllowList.selectorIsAllowed(
                              bytes4(currentSwap.callData[:4])
                          ))
                  ) revert ContractCallNotAllowed();
                  LibSwap.swap(_transactionId, currentSwap);
                  unchecked {
                      ++i;
                  }
              }
          }
          /// @dev Executes swaps and checks that DEXs used are in the allowList
          /// @param _reserveData Data passed used to reserve native tokens
          /// @param _swaps Array of data used to execute swaps
          function _executeSwaps(
              ReserveData memory _reserveData,
              LibSwap.SwapData[] calldata _swaps,
              uint256[] memory _initialBalances
          )
              internal
              noLeftoversReserve(
                  _swaps,
                  _reserveData.leftoverReceiver,
                  _initialBalances,
                  _reserveData.nativeReserve
              )
          {
              uint256 numSwaps = _swaps.length;
              for (uint256 i = 0; i < numSwaps; ) {
                  LibSwap.SwapData calldata currentSwap = _swaps[i];
                  if (
                      !((LibAsset.isNativeAsset(currentSwap.sendingAssetId) ||
                          LibAllowList.contractIsAllowed(currentSwap.approveTo)) &&
                          LibAllowList.contractIsAllowed(currentSwap.callTo) &&
                          LibAllowList.selectorIsAllowed(
                              bytes4(currentSwap.callData[:4])
                          ))
                  ) revert ContractCallNotAllowed();
                  LibSwap.swap(_reserveData.transactionId, currentSwap);
                  unchecked {
                      ++i;
                  }
              }
          }
          /// @dev Fetches balances of tokens to be swapped before swapping.
          /// @param _swaps Array of data used to execute swaps
          /// @return uint256[] Array of token balances.
          function _fetchBalances(
              LibSwap.SwapData[] calldata _swaps
          ) private view returns (uint256[] memory) {
              uint256 numSwaps = _swaps.length;
              uint256[] memory balances = new uint256[](numSwaps);
              address asset;
              for (uint256 i = 0; i < numSwaps; ) {
                  asset = _swaps[i].receivingAssetId;
                  balances[i] = LibAsset.getOwnBalance(asset);
                  if (LibAsset.isNativeAsset(asset)) {
                      balances[i] -= msg.value;
                  }
                  unchecked {
                      ++i;
                  }
              }
              return balances;
          }
      }
      // SPDX-License-Identifier: UNLICENSED
      /// @custom:version 1.0.0
      pragma solidity ^0.8.17;
      import { LibAsset } from "../Libraries/LibAsset.sol";
      import { LibUtil } from "../Libraries/LibUtil.sol";
      import { InvalidReceiver, InformationMismatch, InvalidSendingToken, InvalidAmount, NativeAssetNotSupported, InvalidDestinationChain, CannotBridgeToSameNetwork } from "../Errors/GenericErrors.sol";
      import { ILiFi } from "../Interfaces/ILiFi.sol";
      import { LibSwap } from "../Libraries/LibSwap.sol";
      contract Validatable {
          modifier validateBridgeData(ILiFi.BridgeData memory _bridgeData) {
              if (LibUtil.isZeroAddress(_bridgeData.receiver)) {
                  revert InvalidReceiver();
              }
              if (_bridgeData.minAmount == 0) {
                  revert InvalidAmount();
              }
              if (_bridgeData.destinationChainId == block.chainid) {
                  revert CannotBridgeToSameNetwork();
              }
              _;
          }
          modifier noNativeAsset(ILiFi.BridgeData memory _bridgeData) {
              if (LibAsset.isNativeAsset(_bridgeData.sendingAssetId)) {
                  revert NativeAssetNotSupported();
              }
              _;
          }
          modifier onlyAllowSourceToken(
              ILiFi.BridgeData memory _bridgeData,
              address _token
          ) {
              if (_bridgeData.sendingAssetId != _token) {
                  revert InvalidSendingToken();
              }
              _;
          }
          modifier onlyAllowDestinationChain(
              ILiFi.BridgeData memory _bridgeData,
              uint256 _chainId
          ) {
              if (_bridgeData.destinationChainId != _chainId) {
                  revert InvalidDestinationChain();
              }
              _;
          }
          modifier containsSourceSwaps(ILiFi.BridgeData memory _bridgeData) {
              if (!_bridgeData.hasSourceSwaps) {
                  revert InformationMismatch();
              }
              _;
          }
          modifier doesNotContainSourceSwaps(ILiFi.BridgeData memory _bridgeData) {
              if (_bridgeData.hasSourceSwaps) {
                  revert InformationMismatch();
              }
              _;
          }
          modifier doesNotContainDestinationCalls(
              ILiFi.BridgeData memory _bridgeData
          ) {
              if (_bridgeData.hasDestinationCall) {
                  revert InformationMismatch();
              }
              _;
          }
      }
      // SPDX-License-Identifier: MIT
      pragma solidity ^0.8.4;
      /// @notice Safe ETH and ERC20 transfer library that gracefully handles missing return values.
      /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/SafeTransferLib.sol)
      /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/SafeTransferLib.sol)
      /// @author Permit2 operations from (https://github.com/Uniswap/permit2/blob/main/src/libraries/Permit2Lib.sol)
      ///
      /// @dev Note:
      /// - For ETH transfers, please use `forceSafeTransferETH` for DoS protection.
      /// - For ERC20s, this implementation won't check that a token has code,
      ///   responsibility is delegated to the caller.
      library SafeTransferLib {
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                       CUSTOM ERRORS                        */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev The ETH transfer has failed.
          error ETHTransferFailed();
          /// @dev The ERC20 `transferFrom` has failed.
          error TransferFromFailed();
          /// @dev The ERC20 `transfer` has failed.
          error TransferFailed();
          /// @dev The ERC20 `approve` has failed.
          error ApproveFailed();
          /// @dev The Permit2 operation has failed.
          error Permit2Failed();
          /// @dev The Permit2 amount must be less than `2**160 - 1`.
          error Permit2AmountOverflow();
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                         CONSTANTS                          */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev Suggested gas stipend for contract receiving ETH that disallows any storage writes.
          uint256 internal constant GAS_STIPEND_NO_STORAGE_WRITES = 2300;
          /// @dev Suggested gas stipend for contract receiving ETH to perform a few
          /// storage reads and writes, but low enough to prevent griefing.
          uint256 internal constant GAS_STIPEND_NO_GRIEF = 100000;
          /// @dev The unique EIP-712 domain domain separator for the DAI token contract.
          bytes32 internal constant DAI_DOMAIN_SEPARATOR =
              0xdbb8cf42e1ecb028be3f3dbc922e1d878b963f411dc388ced501601c60f7c6f7;
          /// @dev The address for the WETH9 contract on Ethereum mainnet.
          address internal constant WETH9 = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
          /// @dev The canonical Permit2 address.
          /// [Github](https://github.com/Uniswap/permit2)
          /// [Etherscan](https://etherscan.io/address/0x000000000022D473030F116dDEE9F6B43aC78BA3)
          address internal constant PERMIT2 = 0x000000000022D473030F116dDEE9F6B43aC78BA3;
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                       ETH OPERATIONS                       */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          // If the ETH transfer MUST succeed with a reasonable gas budget, use the force variants.
          //
          // The regular variants:
          // - Forwards all remaining gas to the target.
          // - Reverts if the target reverts.
          // - Reverts if the current contract has insufficient balance.
          //
          // The force variants:
          // - Forwards with an optional gas stipend
          //   (defaults to `GAS_STIPEND_NO_GRIEF`, which is sufficient for most cases).
          // - If the target reverts, or if the gas stipend is exhausted,
          //   creates a temporary contract to force send the ETH via `SELFDESTRUCT`.
          //   Future compatible with `SENDALL`: https://eips.ethereum.org/EIPS/eip-4758.
          // - Reverts if the current contract has insufficient balance.
          //
          // The try variants:
          // - Forwards with a mandatory gas stipend.
          // - Instead of reverting, returns whether the transfer succeeded.
          /// @dev Sends `amount` (in wei) ETH to `to`.
          function safeTransferETH(address to, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  if iszero(call(gas(), to, amount, codesize(), 0x00, codesize(), 0x00)) {
                      mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                      revert(0x1c, 0x04)
                  }
              }
          }
          /// @dev Sends all the ETH in the current contract to `to`.
          function safeTransferAllETH(address to) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  // Transfer all the ETH and check if it succeeded or not.
                  if iszero(call(gas(), to, selfbalance(), codesize(), 0x00, codesize(), 0x00)) {
                      mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                      revert(0x1c, 0x04)
                  }
              }
          }
          /// @dev Force sends `amount` (in wei) ETH to `to`, with a `gasStipend`.
          function forceSafeTransferETH(address to, uint256 amount, uint256 gasStipend) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  if lt(selfbalance(), amount) {
                      mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                      revert(0x1c, 0x04)
                  }
                  if iszero(call(gasStipend, to, amount, codesize(), 0x00, codesize(), 0x00)) {
                      mstore(0x00, to) // Store the address in scratch space.
                      mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                      mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                      if iszero(create(amount, 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
                  }
              }
          }
          /// @dev Force sends all the ETH in the current contract to `to`, with a `gasStipend`.
          function forceSafeTransferAllETH(address to, uint256 gasStipend) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  if iszero(call(gasStipend, to, selfbalance(), codesize(), 0x00, codesize(), 0x00)) {
                      mstore(0x00, to) // Store the address in scratch space.
                      mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                      mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                      if iszero(create(selfbalance(), 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
                  }
              }
          }
          /// @dev Force sends `amount` (in wei) ETH to `to`, with `GAS_STIPEND_NO_GRIEF`.
          function forceSafeTransferETH(address to, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  if lt(selfbalance(), amount) {
                      mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
                      revert(0x1c, 0x04)
                  }
                  if iszero(call(GAS_STIPEND_NO_GRIEF, to, amount, codesize(), 0x00, codesize(), 0x00)) {
                      mstore(0x00, to) // Store the address in scratch space.
                      mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                      mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                      if iszero(create(amount, 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
                  }
              }
          }
          /// @dev Force sends all the ETH in the current contract to `to`, with `GAS_STIPEND_NO_GRIEF`.
          function forceSafeTransferAllETH(address to) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  // forgefmt: disable-next-item
                  if iszero(call(GAS_STIPEND_NO_GRIEF, to, selfbalance(), codesize(), 0x00, codesize(), 0x00)) {
                      mstore(0x00, to) // Store the address in scratch space.
                      mstore8(0x0b, 0x73) // Opcode `PUSH20`.
                      mstore8(0x20, 0xff) // Opcode `SELFDESTRUCT`.
                      if iszero(create(selfbalance(), 0x0b, 0x16)) { revert(codesize(), codesize()) } // For gas estimation.
                  }
              }
          }
          /// @dev Sends `amount` (in wei) ETH to `to`, with a `gasStipend`.
          function trySafeTransferETH(address to, uint256 amount, uint256 gasStipend)
              internal
              returns (bool success)
          {
              /// @solidity memory-safe-assembly
              assembly {
                  success := call(gasStipend, to, amount, codesize(), 0x00, codesize(), 0x00)
              }
          }
          /// @dev Sends all the ETH in the current contract to `to`, with a `gasStipend`.
          function trySafeTransferAllETH(address to, uint256 gasStipend)
              internal
              returns (bool success)
          {
              /// @solidity memory-safe-assembly
              assembly {
                  success := call(gasStipend, to, selfbalance(), codesize(), 0x00, codesize(), 0x00)
              }
          }
          /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
          /*                      ERC20 OPERATIONS                      */
          /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
          /// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
          /// Reverts upon failure.
          ///
          /// The `from` account must have at least `amount` approved for
          /// the current contract to manage.
          function safeTransferFrom(address token, address from, address to, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  let m := mload(0x40) // Cache the free memory pointer.
                  mstore(0x60, amount) // Store the `amount` argument.
                  mstore(0x40, to) // Store the `to` argument.
                  mstore(0x2c, shl(96, from)) // Store the `from` argument.
                  mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`.
                  // Perform the transfer, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x60, 0) // Restore the zero slot to zero.
                  mstore(0x40, m) // Restore the free memory pointer.
              }
          }
          /// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
          ///
          /// The `from` account must have at least `amount` approved for the current contract to manage.
          function trySafeTransferFrom(address token, address from, address to, uint256 amount)
              internal
              returns (bool success)
          {
              /// @solidity memory-safe-assembly
              assembly {
                  let m := mload(0x40) // Cache the free memory pointer.
                  mstore(0x60, amount) // Store the `amount` argument.
                  mstore(0x40, to) // Store the `to` argument.
                  mstore(0x2c, shl(96, from)) // Store the `from` argument.
                  mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`.
                  success :=
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
                      )
                  mstore(0x60, 0) // Restore the zero slot to zero.
                  mstore(0x40, m) // Restore the free memory pointer.
              }
          }
          /// @dev Sends all of ERC20 `token` from `from` to `to`.
          /// Reverts upon failure.
          ///
          /// The `from` account must have their entire balance approved for the current contract to manage.
          function safeTransferAllFrom(address token, address from, address to)
              internal
              returns (uint256 amount)
          {
              /// @solidity memory-safe-assembly
              assembly {
                  let m := mload(0x40) // Cache the free memory pointer.
                  mstore(0x40, to) // Store the `to` argument.
                  mstore(0x2c, shl(96, from)) // Store the `from` argument.
                  mstore(0x0c, 0x70a08231000000000000000000000000) // `balanceOf(address)`.
                  // Read the balance, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          gt(returndatasize(), 0x1f), // At least 32 bytes returned.
                          staticcall(gas(), token, 0x1c, 0x24, 0x60, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x00, 0x23b872dd) // `transferFrom(address,address,uint256)`.
                  amount := mload(0x60) // The `amount` is already at 0x60. We'll need to return it.
                  // Perform the transfer, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x60, 0) // Restore the zero slot to zero.
                  mstore(0x40, m) // Restore the free memory pointer.
              }
          }
          /// @dev Sends `amount` of ERC20 `token` from the current contract to `to`.
          /// Reverts upon failure.
          function safeTransfer(address token, address to, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x14, to) // Store the `to` argument.
                  mstore(0x34, amount) // Store the `amount` argument.
                  mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`.
                  // Perform the transfer, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
              }
          }
          /// @dev Sends all of ERC20 `token` from the current contract to `to`.
          /// Reverts upon failure.
          function safeTransferAll(address token, address to) internal returns (uint256 amount) {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x00, 0x70a08231) // Store the function selector of `balanceOf(address)`.
                  mstore(0x20, address()) // Store the address of the current contract.
                  // Read the balance, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          gt(returndatasize(), 0x1f), // At least 32 bytes returned.
                          staticcall(gas(), token, 0x1c, 0x24, 0x34, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x14, to) // Store the `to` argument.
                  amount := mload(0x34) // The `amount` is already at 0x34. We'll need to return it.
                  mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`.
                  // Perform the transfer, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
              }
          }
          /// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract.
          /// Reverts upon failure.
          function safeApprove(address token, address to, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x14, to) // Store the `to` argument.
                  mstore(0x34, amount) // Store the `amount` argument.
                  mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
                  // Perform the approval, reverting upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                      )
                  ) {
                      mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`.
                      revert(0x1c, 0x04)
                  }
                  mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
              }
          }
          /// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract.
          /// If the initial attempt to approve fails, attempts to reset the approved amount to zero,
          /// then retries the approval again (some tokens, e.g. USDT, requires this).
          /// Reverts upon failure.
          function safeApproveWithRetry(address token, address to, uint256 amount) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x14, to) // Store the `to` argument.
                  mstore(0x34, amount) // Store the `amount` argument.
                  mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
                  // Perform the approval, retrying upon failure.
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                          call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                      )
                  ) {
                      mstore(0x34, 0) // Store 0 for the `amount`.
                      mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
                      pop(call(gas(), token, 0, 0x10, 0x44, codesize(), 0x00)) // Reset the approval.
                      mstore(0x34, amount) // Store back the original `amount`.
                      // Retry the approval, reverting upon failure.
                      if iszero(
                          and(
                              or(eq(mload(0x00), 1), iszero(returndatasize())), // Returned 1 or nothing.
                              call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
                          )
                      ) {
                          mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`.
                          revert(0x1c, 0x04)
                      }
                  }
                  mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
              }
          }
          /// @dev Returns the amount of ERC20 `token` owned by `account`.
          /// Returns zero if the `token` does not exist.
          function balanceOf(address token, address account) internal view returns (uint256 amount) {
              /// @solidity memory-safe-assembly
              assembly {
                  mstore(0x14, account) // Store the `account` argument.
                  mstore(0x00, 0x70a08231000000000000000000000000) // `balanceOf(address)`.
                  amount :=
                      mul( // The arguments of `mul` are evaluated from right to left.
                          mload(0x20),
                          and( // The arguments of `and` are evaluated from right to left.
                              gt(returndatasize(), 0x1f), // At least 32 bytes returned.
                              staticcall(gas(), token, 0x10, 0x24, 0x20, 0x20)
                          )
                      )
              }
          }
          /// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
          /// If the initial attempt fails, try to use Permit2 to transfer the token.
          /// Reverts upon failure.
          ///
          /// The `from` account must have at least `amount` approved for the current contract to manage.
          function safeTransferFrom2(address token, address from, address to, uint256 amount) internal {
              if (!trySafeTransferFrom(token, from, to, amount)) {
                  permit2TransferFrom(token, from, to, amount);
              }
          }
          /// @dev Sends `amount` of ERC20 `token` from `from` to `to` via Permit2.
          /// Reverts upon failure.
          function permit2TransferFrom(address token, address from, address to, uint256 amount)
              internal
          {
              /// @solidity memory-safe-assembly
              assembly {
                  let m := mload(0x40)
                  mstore(add(m, 0x74), shr(96, shl(96, token)))
                  mstore(add(m, 0x54), amount)
                  mstore(add(m, 0x34), to)
                  mstore(add(m, 0x20), shl(96, from))
                  // `transferFrom(address,address,uint160,address)`.
                  mstore(m, 0x36c78516000000000000000000000000)
                  let p := PERMIT2
                  let exists := eq(chainid(), 1)
                  if iszero(exists) { exists := iszero(iszero(extcodesize(p))) }
                  if iszero(and(call(gas(), p, 0, add(m, 0x10), 0x84, codesize(), 0x00), exists)) {
                      mstore(0x00, 0x7939f4248757f0fd) // `TransferFromFailed()` or `Permit2AmountOverflow()`.
                      revert(add(0x18, shl(2, iszero(iszero(shr(160, amount))))), 0x04)
                  }
              }
          }
          /// @dev Permit a user to spend a given amount of
          /// another user's tokens via native EIP-2612 permit if possible, falling
          /// back to Permit2 if native permit fails or is not implemented on the token.
          function permit2(
              address token,
              address owner,
              address spender,
              uint256 amount,
              uint256 deadline,
              uint8 v,
              bytes32 r,
              bytes32 s
          ) internal {
              bool success;
              /// @solidity memory-safe-assembly
              assembly {
                  for {} shl(96, xor(token, WETH9)) {} {
                      mstore(0x00, 0x3644e515) // `DOMAIN_SEPARATOR()`.
                      if iszero(
                          and( // The arguments of `and` are evaluated from right to left.
                              lt(iszero(mload(0x00)), eq(returndatasize(), 0x20)), // Returns 1 non-zero word.
                              // Gas stipend to limit gas burn for tokens that don't refund gas when
                              // an non-existing function is called. 5K should be enough for a SLOAD.
                              staticcall(5000, token, 0x1c, 0x04, 0x00, 0x20)
                          )
                      ) { break }
                      // After here, we can be sure that token is a contract.
                      let m := mload(0x40)
                      mstore(add(m, 0x34), spender)
                      mstore(add(m, 0x20), shl(96, owner))
                      mstore(add(m, 0x74), deadline)
                      if eq(mload(0x00), DAI_DOMAIN_SEPARATOR) {
                          mstore(0x14, owner)
                          mstore(0x00, 0x7ecebe00000000000000000000000000) // `nonces(address)`.
                          mstore(add(m, 0x94), staticcall(gas(), token, 0x10, 0x24, add(m, 0x54), 0x20))
                          mstore(m, 0x8fcbaf0c000000000000000000000000) // `IDAIPermit.permit`.
                          // `nonces` is already at `add(m, 0x54)`.
                          // `1` is already stored at `add(m, 0x94)`.
                          mstore(add(m, 0xb4), and(0xff, v))
                          mstore(add(m, 0xd4), r)
                          mstore(add(m, 0xf4), s)
                          success := call(gas(), token, 0, add(m, 0x10), 0x104, codesize(), 0x00)
                          break
                      }
                      mstore(m, 0xd505accf000000000000000000000000) // `IERC20Permit.permit`.
                      mstore(add(m, 0x54), amount)
                      mstore(add(m, 0x94), and(0xff, v))
                      mstore(add(m, 0xb4), r)
                      mstore(add(m, 0xd4), s)
                      success := call(gas(), token, 0, add(m, 0x10), 0xe4, codesize(), 0x00)
                      break
                  }
              }
              if (!success) simplePermit2(token, owner, spender, amount, deadline, v, r, s);
          }
          /// @dev Simple permit on the Permit2 contract.
          function simplePermit2(
              address token,
              address owner,
              address spender,
              uint256 amount,
              uint256 deadline,
              uint8 v,
              bytes32 r,
              bytes32 s
          ) internal {
              /// @solidity memory-safe-assembly
              assembly {
                  let m := mload(0x40)
                  mstore(m, 0x927da105) // `allowance(address,address,address)`.
                  {
                      let addressMask := shr(96, not(0))
                      mstore(add(m, 0x20), and(addressMask, owner))
                      mstore(add(m, 0x40), and(addressMask, token))
                      mstore(add(m, 0x60), and(addressMask, spender))
                      mstore(add(m, 0xc0), and(addressMask, spender))
                  }
                  let p := mul(PERMIT2, iszero(shr(160, amount)))
                  if iszero(
                      and( // The arguments of `and` are evaluated from right to left.
                          gt(returndatasize(), 0x5f), // Returns 3 words: `amount`, `expiration`, `nonce`.
                          staticcall(gas(), p, add(m, 0x1c), 0x64, add(m, 0x60), 0x60)
                      )
                  ) {
                      mstore(0x00, 0x6b836e6b8757f0fd) // `Permit2Failed()` or `Permit2AmountOverflow()`.
                      revert(add(0x18, shl(2, iszero(p))), 0x04)
                  }
                  mstore(m, 0x2b67b570) // `Permit2.permit` (PermitSingle variant).
                  // `owner` is already `add(m, 0x20)`.
                  // `token` is already at `add(m, 0x40)`.
                  mstore(add(m, 0x60), amount)
                  mstore(add(m, 0x80), 0xffffffffffff) // `expiration = type(uint48).max`.
                  // `nonce` is already at `add(m, 0xa0)`.
                  // `spender` is already at `add(m, 0xc0)`.
                  mstore(add(m, 0xe0), deadline)
                  mstore(add(m, 0x100), 0x100) // `signature` offset.
                  mstore(add(m, 0x120), 0x41) // `signature` length.
                  mstore(add(m, 0x140), r)
                  mstore(add(m, 0x160), s)
                  mstore(add(m, 0x180), shl(248, v))
                  if iszero(call(gas(), p, 0, add(m, 0x1c), 0x184, codesize(), 0x00)) {
                      mstore(0x00, 0x6b836e6b) // `Permit2Failed()`.
                      revert(0x1c, 0x04)
                  }
              }
          }
      }
      // SPDX-License-Identifier: LGPL-3.0-only
      /// @custom:version 1.0.1
      pragma solidity ^0.8.17;
      error AlreadyInitialized();
      error CannotAuthoriseSelf();
      error CannotBridgeToSameNetwork();
      error ContractCallNotAllowed();
      error CumulativeSlippageTooHigh(uint256 minAmount, uint256 receivedAmount);
      error DiamondIsPaused();
      error ETHTransferFailed();
      error ExternalCallFailed();
      error FunctionDoesNotExist();
      error InformationMismatch();
      error InsufficientBalance(uint256 required, uint256 balance);
      error InvalidAmount();
      error InvalidCallData();
      error InvalidConfig();
      error InvalidContract();
      error InvalidDestinationChain();
      error InvalidFallbackAddress();
      error InvalidReceiver();
      error InvalidSendingToken();
      error NativeAssetNotSupported();
      error NativeAssetTransferFailed();
      error NoSwapDataProvided();
      error NoSwapFromZeroBalance();
      error NotAContract();
      error NotInitialized();
      error NoTransferToNullAddress();
      error NullAddrIsNotAnERC20Token();
      error NullAddrIsNotAValidSpender();
      error OnlyContractOwner();
      error RecoveryAddressCannotBeZero();
      error ReentrancyError();
      error TokenNotSupported();
      error TransferFromFailed();
      error UnAuthorized();
      error UnsupportedChainId(uint256 chainId);
      error WithdrawFailed();
      error ZeroAmount();
      // SPDX-License-Identifier: LGPL-3.0-only
      /// @custom:version 1.0.0
      pragma solidity ^0.8.17;
      // solhint-disable-next-line no-global-import
      import "./LibBytes.sol";
      library LibUtil {
          using LibBytes for bytes;
          function getRevertMsg(
              bytes memory _res
          ) internal pure returns (string memory) {
              // If the _res length is less than 68, then the transaction failed silently (without a revert message)
              if (_res.length < 68) return "Transaction reverted silently";
              bytes memory revertData = _res.slice(4, _res.length - 4); // Remove the selector which is the first 4 bytes
              return abi.decode(revertData, (string)); // All that remains is the revert string
          }
          /// @notice Determines whether the given address is the zero address
          /// @param addr The address to verify
          /// @return Boolean indicating if the address is the zero address
          function isZeroAddress(address addr) internal pure returns (bool) {
              return addr == address(0);
          }
          function revertWith(bytes memory data) internal pure {
              assembly {
                  let dataSize := mload(data) // Load the size of the data
                  let dataPtr := add(data, 0x20) // Advance data pointer to the next word
                  revert(dataPtr, dataSize) // Revert with the given data
              }
          }
      }
      // 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: LGPL-3.0-only
      /// @custom:version 1.0.0
      pragma solidity ^0.8.17;
      import { InvalidContract } from "../Errors/GenericErrors.sol";
      /// @title Lib Allow List
      /// @author LI.FI (https://li.fi)
      /// @notice Library for managing and accessing the conract address allow list
      library LibAllowList {
          /// Storage ///
          bytes32 internal constant NAMESPACE =
              keccak256("com.lifi.library.allow.list");
          struct AllowListStorage {
              mapping(address => bool) allowlist;
              mapping(bytes4 => bool) selectorAllowList;
              address[] contracts;
          }
          /// @dev Adds a contract address to the allow list
          /// @param _contract the contract address to add
          function addAllowedContract(address _contract) internal {
              _checkAddress(_contract);
              AllowListStorage storage als = _getStorage();
              if (als.allowlist[_contract]) return;
              als.allowlist[_contract] = true;
              als.contracts.push(_contract);
          }
          /// @dev Checks whether a contract address has been added to the allow list
          /// @param _contract the contract address to check
          function contractIsAllowed(
              address _contract
          ) internal view returns (bool) {
              return _getStorage().allowlist[_contract];
          }
          /// @dev Remove a contract address from the allow list
          /// @param _contract the contract address to remove
          function removeAllowedContract(address _contract) internal {
              AllowListStorage storage als = _getStorage();
              if (!als.allowlist[_contract]) {
                  return;
              }
              als.allowlist[_contract] = false;
              uint256 length = als.contracts.length;
              // Find the contract in the list
              for (uint256 i = 0; i < length; i++) {
                  if (als.contracts[i] == _contract) {
                      // Move the last element into the place to delete
                      als.contracts[i] = als.contracts[length - 1];
                      // Remove the last element
                      als.contracts.pop();
                      break;
                  }
              }
          }
          /// @dev Fetch contract addresses from the allow list
          function getAllowedContracts() internal view returns (address[] memory) {
              return _getStorage().contracts;
          }
          /// @dev Add a selector to the allow list
          /// @param _selector the selector to add
          function addAllowedSelector(bytes4 _selector) internal {
              _getStorage().selectorAllowList[_selector] = true;
          }
          /// @dev Removes a selector from the allow list
          /// @param _selector the selector to remove
          function removeAllowedSelector(bytes4 _selector) internal {
              _getStorage().selectorAllowList[_selector] = false;
          }
          /// @dev Returns if selector has been added to the allow list
          /// @param _selector the selector to check
          function selectorIsAllowed(bytes4 _selector) internal view returns (bool) {
              return _getStorage().selectorAllowList[_selector];
          }
          /// @dev Fetch local storage struct
          function _getStorage()
              internal
              pure
              returns (AllowListStorage storage als)
          {
              bytes32 position = NAMESPACE;
              // solhint-disable-next-line no-inline-assembly
              assembly {
                  als.slot := position
              }
          }
          /// @dev Contains business logic for validating a contract address.
          /// @param _contract address of the dex to check
          function _checkAddress(address _contract) private view {
              if (_contract == address(0)) revert InvalidContract();
              if (_contract.code.length == 0) revert InvalidContract();
          }
      }
      // SPDX-License-Identifier: LGPL-3.0-only
      /// @custom:version 1.0.0
      pragma solidity ^0.8.17;
      library LibBytes {
          // solhint-disable no-inline-assembly
          // LibBytes specific errors
          error SliceOverflow();
          error SliceOutOfBounds();
          error AddressOutOfBounds();
          bytes16 private constant _SYMBOLS = "0123456789abcdef";
          // -------------------------
          function slice(
              bytes memory _bytes,
              uint256 _start,
              uint256 _length
          ) internal pure returns (bytes memory) {
              if (_length + 31 < _length) revert SliceOverflow();
              if (_bytes.length < _start + _length) revert SliceOutOfBounds();
              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) {
              if (_bytes.length < _start + 20) {
                  revert AddressOutOfBounds();
              }
              address tempAddress;
              assembly {
                  tempAddress := div(
                      mload(add(add(_bytes, 0x20), _start)),
                      0x1000000000000000000000000
                  )
              }
              return tempAddress;
          }
          /// Copied from OpenZeppelin's `Strings.sol` utility library.
          /// https://github.com/OpenZeppelin/openzeppelin-contracts/blob/8335676b0e99944eef6a742e16dcd9ff6e68e609/contracts/utils/Strings.sol
          function toHexString(
              uint256 value,
              uint256 length
          ) internal pure returns (string memory) {
              bytes memory buffer = new bytes(2 * length + 2);
              buffer[0] = "0";
              buffer[1] = "x";
              for (uint256 i = 2 * length + 1; i > 1; --i) {
                  buffer[i] = _SYMBOLS[value & 0xf];
                  value >>= 4;
              }
              // solhint-disable-next-line gas-custom-errors
              require(value == 0, "Strings: hex length insufficient");
              return string(buffer);
          }
      }