ETH Price: $2,279.32 (+3.52%)

Transaction Decoder

Block:
19461131 at Mar-18-2024 10:37:11 AM +UTC
Transaction Fee:
0.002348783748223146 ETH $5.35
Gas Used:
91,754 Gas / 25.598706849 Gwei

Emitted Events:

46 BridgeToken.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x000000000000000000000000b05c28d08ef8d9afb6cc7ba3894bb179a0090d97, 0x000000000000000000000000a1bd0b130e0bbc75d6da50d93522eb5e478ce7d4, 00000000000000000000000000000000000000000000031ce37b140fe2300000 )
47 SHO.Claim1( user=[Sender] 0xa1bd0b130e0bbc75d6da50d93522eb5e478ce7d4, currentUnlock=2, claimedTokens=14700000000000000000000 )

Account State Difference:

  Address   Before After State Difference Code
(beaverbuild)
14.652416660973740897 Eth14.652424918833740897 Eth0.00000825786
0xA1BD0B13...E478ce7D4
0.100001881714929099 Eth
Nonce: 86
0.097653097966705953 Eth
Nonce: 87
0.002348783748223146
0xB05C28D0...9a0090d97
0xB4b9DC1C...d98883A35

Execution Trace

SHO.CALL( )
  • BridgeToken.a9059cbb( )
    • TokenBridge.STATICCALL( )
      • BridgeImplementation.DELEGATECALL( )
      • TokenImplementation.transfer( recipient_=0xA1BD0B130e0BBc75d6dA50d93522EB5E478ce7D4, amount_=14700000000000000000000 ) => ( True )
        File 1 of 5: SHO
        //SPDX-License-Identifier: MIT
        pragma solidity =0.8.4;
        import "@openzeppelin/contracts/access/Ownable.sol";
        import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
        import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
        import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
        contract SHO is Ownable, ReentrancyGuard {
            using SafeERC20 for IERC20;
            uint32 constant HUNDRED_PERCENT = 1e6;
            struct User1 {
                uint16 claimedUnlocksCount;
                uint16 eliminatedAfterUnlock;
                uint120 allocation;
            }
            struct User2 {
                uint120 allocation;
                uint120 debt;
                uint16 claimedUnlocksCount;
                uint120 currentUnlocked;
                uint120 currentClaimed;
                uint120 totalUnlocked;
                uint120 totalClaimed;
            }
            mapping(address => User1) public users1;
            mapping(address => User2) public users2;
            IERC20 public immutable shoToken;
            uint64 public immutable startTime;
            address public immutable feeCollector;
            uint32 public immutable baseFeePercentage1;
            uint32 public immutable baseFeePercentage2;
            uint32 public immutable freeClaimablePercentage;
            address public immutable burnValley;
            uint32 public immutable burnPercentage;
            uint32[] public unlockPercentages;
            uint32[] public unlockPeriods;
            uint120[] public extraFees2;
            bool public whitelistingAllowed = true;
            uint16 passedUnlocksCount;
            uint120 public globalTotalAllocation1;
            uint120 public globalTotalAllocation2;
            uint16 public collectedFeesUnlocksCount;
            uint120 public extraFees1Allocation;
            uint120 public extraFees1AllocationUncollectable;
            event Whitelist (
                address user,
                uint120 allocation,
                uint8 option
            );
            event Claim1 (
                address indexed user,
                uint16 currentUnlock,
                uint120 claimedTokens
            );
            event Claim2 (
                address indexed user,
                uint16 currentUnlock,
                uint120 claimedTokens,
                uint120 baseClaimed,
                uint120 chargedfee
            );
            event FeeCollection (
                uint16 currentUnlock,
                uint120 totalFee,
                uint120 extraFee,
                uint120 burned
            );
            event UserElimination (
                address user,
                uint16 currentUnlock
            );
            event Update (
                uint16 passedUnlocksCount
            );
            modifier onlyWhitelistedUser1(address userAddress) {
                require(users1[userAddress].allocation > 0, "SHO: passed address is not whitelisted or does not have the correct option");
                _;
            }
            modifier onlyWhitelistedUser2() {
                require(users2[msg.sender].allocation > 0, "SHO: caller is not whitelisted or does not have the correct option");
                _;
            }
            /**
                @param _shoToken token that whitelisted users claim
                @param _unlockPercentagesDiff array of unlock percentages as differentials
                    (how much of total user's whitelisted allocation can a user claim per unlock) 
                @param _unlockPeriodsDiff array of unlock periods as differentials
                    (when unlocks happen from startTime)
                @param _baseFeePercentage1 base fee in percentage for option 1 users
                @param _baseFeePercentage2 base fee in percentage for option 2 users
                @param _feeCollector EOA that receives fees
                @param _startTime when users can start claiming
                @param _burnValley burned tokens are sent to this address if the SHO token is not burnable
                @param _burnPercentage burn percentage of extra fees
                @param _freeClaimablePercentage how much can users of type 2 claim in the current unlock without a fee
             */
            constructor(
                IERC20 _shoToken,
                uint32[] memory _unlockPercentagesDiff,
                uint32[] memory _unlockPeriodsDiff,
                uint32 _baseFeePercentage1,
                uint32 _baseFeePercentage2,
                address _feeCollector,
                uint64 _startTime,
                address _burnValley,
                uint32 _burnPercentage,
                uint32 _freeClaimablePercentage
            ) {
                require(address(_shoToken) != address(0), "SHO: sho token zero address");
                require(_unlockPercentagesDiff.length > 0, "SHO: 0 unlock percentages");
                require(_unlockPercentagesDiff.length <= 800, "SHO: too many unlock percentages");
                require(_unlockPeriodsDiff.length == _unlockPercentagesDiff.length, "SHO: different array lengths");
                require(_baseFeePercentage1 <= HUNDRED_PERCENT, "SHO: base fee percentage 1 higher than 100%");
                require(_baseFeePercentage2 <= HUNDRED_PERCENT, "SHO: base fee percentage 2 higher than 100%");
                require(_feeCollector != address(0), "SHO: fee collector zero address");
                require(_startTime > block.timestamp, "SHO: start time must be in future");
                require(_burnValley != address(0), "SHO: burn valley zero address");
                require(_burnPercentage <= HUNDRED_PERCENT, "SHO: burn percentage higher than 100%");
                require(_freeClaimablePercentage <= HUNDRED_PERCENT, "SHO: free claimable percentage higher than 100%");
                // build arrays of sums for easier calculations
                uint32[] memory _unlockPercentages = _buildArraySum(_unlockPercentagesDiff);
                uint32[] memory _unlockPeriods = _buildArraySum(_unlockPeriodsDiff);
                require(_unlockPercentages[_unlockPercentages.length - 1] == HUNDRED_PERCENT, "SHO: invalid unlock percentages");
                shoToken = _shoToken;
                unlockPercentages = _unlockPercentages;
                unlockPeriods = _unlockPeriods;
                baseFeePercentage1 = _baseFeePercentage1;
                baseFeePercentage2 = _baseFeePercentage2;
                feeCollector = _feeCollector;
                startTime = _startTime;
                burnValley = _burnValley;
                burnPercentage = _burnPercentage;
                freeClaimablePercentage = _freeClaimablePercentage;
                extraFees2 = new uint120[](_unlockPercentagesDiff.length);
            }
            /** 
                @param userAddresses addresses to whitelist
                @param allocations users total allocation
                @param options user types
            */
            function whitelistUsers(
                address[] calldata userAddresses,
                uint120[] calldata allocations,
                uint8[] calldata options,
                bool last
            ) external onlyOwner {
                require(whitelistingAllowed, "SHO: whitelisting not allowed anymore");
                require(userAddresses.length != 0, "SHO: zero length array");
                require(userAddresses.length == allocations.length, "SHO: different array lengths");
                require(userAddresses.length == options.length, "SHO: different array lengths");
                uint120 _globalTotalAllocation1;
                uint120 _globalTotalAllocation2;
                for (uint256 i = 0; i < userAddresses.length; i++) {
                    address userAddress = userAddresses[i];
                    require(options[i] == 1 || options[i] == 2, "SHO: invalid user option");
                    require(users1[userAddress].allocation == 0, "SHO: some users are already whitelisted");
                    require(users2[userAddress].allocation == 0, "SHO: some users are already whitelisted");
                    if (options[i] == 1) {
                        users1[userAddress].allocation = allocations[i];
                        _globalTotalAllocation1 += allocations[i];
                    } else if (options[i] == 2) {
                        users2[userAddress].allocation = allocations[i];
                        _globalTotalAllocation2 += allocations[i];
                    }
                    emit Whitelist(
                        userAddresses[i],
                        allocations[i],
                        options[i]
                    );
                }
                    
                globalTotalAllocation1 += _globalTotalAllocation1;
                globalTotalAllocation2 += _globalTotalAllocation2;
                
                if (last) {
                    whitelistingAllowed = false;
                }
            }
            function claimUser1() external returns (uint120 amountToClaim) {
                return claimUser1(msg.sender);
            }
            /**
                Users type 1 claims all the available amount without increasing the fee.
                (there's still the baseFee deducted from their allocation).
            */
            function claimUser1(address userAddress) onlyWhitelistedUser1(userAddress) public nonReentrant returns (uint120 amountToClaim) {
                update();
                User1 memory user = users1[userAddress];
                require(passedUnlocksCount > 0, "SHO: no unlocks passed");
                require(user.claimedUnlocksCount < passedUnlocksCount, "SHO: nothing to claim");
                uint16 currentUnlock = passedUnlocksCount - 1;
                if (user.eliminatedAfterUnlock > 0) {
                    require(user.claimedUnlocksCount < user.eliminatedAfterUnlock, "SHO: nothing to claim");
                    currentUnlock = user.eliminatedAfterUnlock - 1;
                }
                uint32 lastUnlockPercentage = user.claimedUnlocksCount > 0 ? unlockPercentages[user.claimedUnlocksCount - 1] : 0;
                amountToClaim = _applyPercentage(user.allocation, unlockPercentages[currentUnlock] - lastUnlockPercentage);
                amountToClaim = _applyBaseFee(amountToClaim, 1);
                user.claimedUnlocksCount = currentUnlock + 1;
                users1[userAddress] = user;
                shoToken.safeTransfer(userAddress, amountToClaim);
                emit Claim1(
                    userAddress, 
                    currentUnlock,
                    amountToClaim
                );
            }
            /**
                Removes all the future allocation of passed user type 1 addresses.
                They can still claim the unlock they were eliminated in.
                @param userAddresses whitelisted user addresses to eliminate
             */
            function eliminateUsers1(address[] calldata userAddresses) external onlyOwner {
                update();
                require(passedUnlocksCount > 0, "SHO: no unlocks passed");
                uint16 currentUnlock = passedUnlocksCount - 1;
                require(currentUnlock < unlockPeriods.length - 1, "SHO: eliminating in the last unlock");
                for (uint256 i = 0; i < userAddresses.length; i++) {
                    address userAddress = userAddresses[i];
                    User1 memory user = users1[userAddress];
                    require(user.allocation > 0, "SHO: some user not option 1");
                    require(user.eliminatedAfterUnlock == 0, "SHO: some user already eliminated");
                    uint120 userAllocation = _applyBaseFee(user.allocation, 1);
                    uint120 uncollectable = _applyPercentage(userAllocation, unlockPercentages[currentUnlock]);
                    extraFees1Allocation += userAllocation;
                    extraFees1AllocationUncollectable += uncollectable;
                    users1[userAddress].eliminatedAfterUnlock = currentUnlock + 1;
                    emit UserElimination(
                        userAddress,
                        currentUnlock
                    );
                }
            }
            
            /**
                User type 2 claims all the remaining amount of previous unlocks and can claim up to baseFeePercentage of the current unlock tokens without causing a fee.
                @param extraAmountToClaim the extra amount is also equal to the charged fee (user claims 100 more the first unlock, can claim 200 less the second unlock)
            */
            function claimUser2(
                uint120 extraAmountToClaim
            ) external nonReentrant onlyWhitelistedUser2 returns (
                uint120 amountToClaim, 
                uint120 baseClaimAmount, 
                uint120 currentUnlocked
            ) {
                update();
                User2 memory user = users2[msg.sender];
                require(passedUnlocksCount > 0, "SHO: no unlocks passed");
                uint16 currentUnlock = passedUnlocksCount - 1;
                if (user.claimedUnlocksCount < passedUnlocksCount) {
                    amountToClaim = _updateUserCurrent(user, currentUnlock);
                    baseClaimAmount = _getCurrentBaseClaimAmount(user, currentUnlock);
                    amountToClaim += baseClaimAmount;
                    user.currentClaimed += baseClaimAmount;
                } else {
                    require(extraAmountToClaim > 0, "SHO: nothing to claim");
                }
                currentUnlocked = user.currentUnlocked;
                if (extraAmountToClaim > 0) {
                    require(extraAmountToClaim <= user.currentUnlocked - user.currentClaimed, "SHO: passed extra amount too high");
                    amountToClaim += extraAmountToClaim;
                    user.currentClaimed += extraAmountToClaim;
                    _chargeFee(user, extraAmountToClaim, currentUnlock);
                }
                require(amountToClaim > 0, "SHO: nothing to claim");
                user.totalClaimed += amountToClaim;
                users2[msg.sender] = user;
                shoToken.safeTransfer(msg.sender, amountToClaim);
                emit Claim2(
                    msg.sender, 
                    currentUnlock,
                    amountToClaim,
                    baseClaimAmount,
                    extraAmountToClaim
                );
            }
            /**
                It's important that the fees are collectable not depedning on if users are claiming.
                Anybody can call this but the fees go to the fee collector.
             */ 
            function collectFees() external nonReentrant returns (uint120 baseFee, uint120 extraFee, uint120 burned) {
                update();
                require(collectedFeesUnlocksCount < passedUnlocksCount, "SHO: no fees to collect");
                uint16 currentUnlock = passedUnlocksCount - 1;
                // base fee from users type 1 and 2
                uint32 lastUnlockPercentage = collectedFeesUnlocksCount > 0 ? unlockPercentages[collectedFeesUnlocksCount - 1] : 0;
                uint120 globalAllocation1 = _applyPercentage(globalTotalAllocation1, unlockPercentages[currentUnlock] - lastUnlockPercentage);
                uint120 globalAllocation2 = _applyPercentage(globalTotalAllocation2, unlockPercentages[currentUnlock] - lastUnlockPercentage);
                baseFee = _applyPercentage(globalAllocation1, baseFeePercentage1);
                baseFee += _applyPercentage(globalAllocation2, baseFeePercentage2);
                // extra fees from users type 2
                uint120 extraFee2;
                if (globalTotalAllocation2 > 0) {
                    for (uint16 i = collectedFeesUnlocksCount; i <= currentUnlock; i++) {
                        extraFee2 += extraFees2[i];
                    }
                }
                // extra fees from users type 1
                uint120 extraFees1AllocationTillNow = _applyPercentage(extraFees1Allocation, unlockPercentages[currentUnlock]);
                uint120 extraFee1 = extraFees1AllocationTillNow - extraFees1AllocationUncollectable;
                extraFees1AllocationUncollectable = extraFees1AllocationTillNow;
                extraFee = extraFee1 + extraFee2;
                uint120 totalFee = baseFee + extraFee;
                burned = _burn(extraFee);
                collectedFeesUnlocksCount = currentUnlock + 1;
                shoToken.safeTransfer(feeCollector, totalFee - burned);
                emit FeeCollection(
                    currentUnlock,
                    totalFee,
                    extraFee,
                    burned
                );
            }
            /**  
                Updates passedUnlocksCount.
            */
            function update() public {
                uint16 _passedUnlocksCount = getPassedUnlocksCount();
                if (_passedUnlocksCount > passedUnlocksCount) {
                    passedUnlocksCount = _passedUnlocksCount;
                    emit Update(_passedUnlocksCount);
                }
            }
            // PUBLIC VIEW FUNCTIONS
            function getPassedUnlocksCount() public view returns (uint16 _passedUnlocksCount) {
                require(block.timestamp >= startTime, "SHO: before startTime");
                uint256 timeSinceStart = block.timestamp - startTime;
                uint256 maxReleases = unlockPeriods.length;
                _passedUnlocksCount = passedUnlocksCount;
                while (_passedUnlocksCount < maxReleases && timeSinceStart >= unlockPeriods[_passedUnlocksCount]) {
                    _passedUnlocksCount++;
                }
            }
            function getTotalUnlocksCount() public view returns (uint16 totalUnlocksCount) {
                return uint16(unlockPercentages.length);
            }
            // PRIVATE FUNCTIONS
            function _burn(uint120 amount) private returns (uint120 burned) {
                burned = _applyPercentage(amount, burnPercentage);
                if (burned == 0) return 0;
                uint256 balanceBefore = shoToken.balanceOf(address(this));
                address(shoToken).call(abi.encodeWithSignature("burn(uint256)", burned));
                uint256 balanceAfter = shoToken.balanceOf(address(this));
                if (balanceBefore == balanceAfter) {
                    shoToken.safeTransfer(burnValley, burned);
                }
            }
            function _updateUserCurrent(User2 memory user, uint16 currentUnlock) private view returns (uint120 claimableFromPreviousUnlocks) {
                claimableFromPreviousUnlocks = _getClaimableFromPreviousUnlocks(user, currentUnlock);
                uint120 newUnlocked = claimableFromPreviousUnlocks - (user.currentUnlocked - user.currentClaimed);
                uint32 unlockPercentageDiffCurrent = currentUnlock > 0 ?
                    unlockPercentages[currentUnlock] - unlockPercentages[currentUnlock - 1] : unlockPercentages[currentUnlock];
                uint120 currentUnlocked = _applyPercentage(user.allocation, unlockPercentageDiffCurrent);
                currentUnlocked = _applyBaseFee(currentUnlocked, 2);
                newUnlocked += currentUnlocked;
                if (newUnlocked >= user.debt) {
                    newUnlocked -= user.debt;
                } else {
                    newUnlocked = 0;
                }
                if (claimableFromPreviousUnlocks >= user.debt) {
                    claimableFromPreviousUnlocks -= user.debt;
                    user.debt = 0;
                } else {
                    user.debt -= claimableFromPreviousUnlocks;
                    claimableFromPreviousUnlocks = 0;
                }
                if (currentUnlocked >= user.debt) {
                    currentUnlocked -= user.debt;
                    user.debt = 0;
                } else {
                    user.debt -= currentUnlocked;
                    currentUnlocked = 0;
                }
                
                user.totalUnlocked += newUnlocked;
                user.currentUnlocked = currentUnlocked;
                user.currentClaimed = 0;
                user.claimedUnlocksCount = passedUnlocksCount;
            }
            function _getClaimableFromPreviousUnlocks(User2 memory user, uint16 currentUnlock) private view returns (uint120 claimableFromPreviousUnlocks) {
                uint32 lastUnlockPercentage = user.claimedUnlocksCount > 0 ? unlockPercentages[user.claimedUnlocksCount - 1] : 0;
                uint32 previousUnlockPercentage = currentUnlock > 0 ? unlockPercentages[currentUnlock - 1] : 0;
                uint120 claimableFromMissedUnlocks = _applyPercentage(user.allocation, previousUnlockPercentage - lastUnlockPercentage);
                claimableFromMissedUnlocks = _applyBaseFee(claimableFromMissedUnlocks, 2);
                
                claimableFromPreviousUnlocks = user.currentUnlocked - user.currentClaimed;
                claimableFromPreviousUnlocks += claimableFromMissedUnlocks;
            }
            function _getCurrentBaseClaimAmount(User2 memory user, uint16 currentUnlock) private view returns (uint120 baseClaimAmount) {
                if (currentUnlock < unlockPeriods.length - 1) {
                    baseClaimAmount =_applyPercentage(user.currentUnlocked, freeClaimablePercentage);
                } else {
                    baseClaimAmount = user.currentUnlocked;
                }
            }
            function _chargeFee(User2 memory user, uint120 fee, uint16 currentUnlock) private {
                user.debt += fee;
                while (fee > 0 && currentUnlock < unlockPeriods.length - 1) {
                    uint16 nextUnlock = currentUnlock + 1;
                    uint120 nextUserAvailable = _applyPercentage(user.allocation, unlockPercentages[nextUnlock] - unlockPercentages[currentUnlock]);
                    nextUserAvailable = _applyBaseFee(nextUserAvailable, 2);
                    uint120 currentUnlockFee = fee <= nextUserAvailable ? fee : nextUserAvailable;
                    extraFees2[nextUnlock] += currentUnlockFee;
                    fee -= currentUnlockFee;
                    currentUnlock++;
                }
            }
            function _applyPercentage(uint120 value, uint32 percentage) private pure returns (uint120) {
                return uint120(uint256(value) * percentage / HUNDRED_PERCENT);
            }
            function _applyBaseFee(uint120 value, uint8 option) private view returns (uint120) {
                return value - _applyPercentage(value, option == 1 ? baseFeePercentage1 : baseFeePercentage2);
            }
            function _buildArraySum(uint32[] memory diffArray) internal pure returns (uint32[] memory) {
                uint256 len = diffArray.length;
                uint32[] memory sumArray = new uint32[](len);
                uint32 lastSum = 0;
                for (uint256 i = 0; i < len; i++) {
                    if (i > 0) {
                        lastSum = sumArray[i - 1];
                    }
                    sumArray[i] = lastSum + diffArray[i];
                }
                return sumArray;
            }
        }// SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.0 (access/Ownable.sol)
        pragma solidity ^0.8.0;
        import "../utils/Context.sol";
        /**
         * @dev Contract module which provides a basic access control mechanism, where
         * there is an account (an owner) that can be granted exclusive access to
         * specific functions.
         *
         * By default, the owner account will be the one that deploys the contract. This
         * can later be changed with {transferOwnership}.
         *
         * This module is used through inheritance. It will make available the modifier
         * `onlyOwner`, which can be applied to your functions to restrict their use to
         * the owner.
         */
        abstract contract Ownable is Context {
            address private _owner;
            event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
            /**
             * @dev Initializes the contract setting the deployer as the initial owner.
             */
            constructor() {
                _transferOwnership(_msgSender());
            }
            /**
             * @dev Returns the address of the current owner.
             */
            function owner() public view virtual returns (address) {
                return _owner;
            }
            /**
             * @dev Throws if called by any account other than the owner.
             */
            modifier onlyOwner() {
                require(owner() == _msgSender(), "Ownable: caller is not the owner");
                _;
            }
            /**
             * @dev Leaves the contract without owner. It will not be possible to call
             * `onlyOwner` functions anymore. Can only be called by the current owner.
             *
             * NOTE: Renouncing ownership will leave the contract without an owner,
             * thereby removing any functionality that is only available to the owner.
             */
            function renounceOwnership() public virtual onlyOwner {
                _transferOwnership(address(0));
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Can only be called by the current owner.
             */
            function transferOwnership(address newOwner) public virtual onlyOwner {
                require(newOwner != address(0), "Ownable: new owner is the zero address");
                _transferOwnership(newOwner);
            }
            /**
             * @dev Transfers ownership of the contract to a new account (`newOwner`).
             * Internal function without access restriction.
             */
            function _transferOwnership(address newOwner) internal virtual {
                address oldOwner = _owner;
                _owner = newOwner;
                emit OwnershipTransferred(oldOwner, newOwner);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.0 (token/ERC20/utils/SafeERC20.sol)
        pragma solidity ^0.8.0;
        import "../IERC20.sol";
        import "../../../utils/Address.sol";
        /**
         * @title SafeERC20
         * @dev Wrappers around ERC20 operations that throw on failure (when the token
         * contract returns false). Tokens that return no value (and instead revert or
         * throw on failure) are also supported, non-reverting calls are assumed to be
         * successful.
         * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
         * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
         */
        library SafeERC20 {
            using Address for address;
            function safeTransfer(
                IERC20 token,
                address to,
                uint256 value
            ) internal {
                _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
            }
            function safeTransferFrom(
                IERC20 token,
                address from,
                address to,
                uint256 value
            ) internal {
                _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
            }
            /**
             * @dev Deprecated. This function has issues similar to the ones found in
             * {IERC20-approve}, and its usage is discouraged.
             *
             * Whenever possible, use {safeIncreaseAllowance} and
             * {safeDecreaseAllowance} instead.
             */
            function safeApprove(
                IERC20 token,
                address spender,
                uint256 value
            ) internal {
                // safeApprove should only be called when setting an initial allowance,
                // or when resetting it to zero. To increase and decrease it, use
                // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                require(
                    (value == 0) || (token.allowance(address(this), spender) == 0),
                    "SafeERC20: approve from non-zero to non-zero allowance"
                );
                _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
            }
            function safeIncreaseAllowance(
                IERC20 token,
                address spender,
                uint256 value
            ) internal {
                uint256 newAllowance = token.allowance(address(this), spender) + value;
                _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
            }
            function safeDecreaseAllowance(
                IERC20 token,
                address spender,
                uint256 value
            ) internal {
                unchecked {
                    uint256 oldAllowance = token.allowance(address(this), spender);
                    require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
                    uint256 newAllowance = oldAllowance - value;
                    _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                }
            }
            /**
             * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
             * on the return value: the return value is optional (but if data is returned, it must not be false).
             * @param token The token targeted by the call.
             * @param data The call data (encoded using abi.encode or one of its variants).
             */
            function _callOptionalReturn(IERC20 token, bytes memory data) private {
                // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
                // the target address contains contract code and also asserts for success in the low-level call.
                bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                if (returndata.length > 0) {
                    // Return data is optional
                    require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.0 (token/ERC20/IERC20.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC20 standard as defined in the EIP.
         */
        interface IERC20 {
            /**
             * @dev Returns the amount of tokens in existence.
             */
            function totalSupply() external view returns (uint256);
            /**
             * @dev Returns the amount of tokens owned by `account`.
             */
            function balanceOf(address account) external view returns (uint256);
            /**
             * @dev Moves `amount` tokens from the caller's account to `recipient`.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transfer(address recipient, uint256 amount) external returns (bool);
            /**
             * @dev Returns the remaining number of tokens that `spender` will be
             * allowed to spend on behalf of `owner` through {transferFrom}. This is
             * zero by default.
             *
             * This value changes when {approve} or {transferFrom} are called.
             */
            function allowance(address owner, address spender) external view returns (uint256);
            /**
             * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * IMPORTANT: Beware that changing an allowance with this method brings the risk
             * that someone may use both the old and the new allowance by unfortunate
             * transaction ordering. One possible solution to mitigate this race
             * condition is to first reduce the spender's allowance to 0 and set the
             * desired value afterwards:
             * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
             *
             * Emits an {Approval} event.
             */
            function approve(address spender, uint256 amount) external returns (bool);
            /**
             * @dev Moves `amount` tokens from `sender` to `recipient` using the
             * allowance mechanism. `amount` is then deducted from the caller's
             * allowance.
             *
             * Returns a boolean value indicating whether the operation succeeded.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address sender,
                address recipient,
                uint256 amount
            ) external returns (bool);
            /**
             * @dev Emitted when `value` tokens are moved from one account (`from`) to
             * another (`to`).
             *
             * Note that `value` may be zero.
             */
            event Transfer(address indexed from, address indexed to, uint256 value);
            /**
             * @dev Emitted when the allowance of a `spender` for an `owner` is set by
             * a call to {approve}. `value` is the new allowance.
             */
            event Approval(address indexed owner, address indexed spender, uint256 value);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.0 (security/ReentrancyGuard.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Contract module that helps prevent reentrant calls to a function.
         *
         * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
         * available, which can be applied to functions to make sure there are no nested
         * (reentrant) calls to them.
         *
         * Note that because there is a single `nonReentrant` guard, functions marked as
         * `nonReentrant` may not call one another. This can be worked around by making
         * those functions `private`, and then adding `external` `nonReentrant` entry
         * points to them.
         *
         * TIP: If you would like to learn more about reentrancy and alternative ways
         * to protect against it, check out our blog post
         * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
         */
        abstract contract ReentrancyGuard {
            // Booleans are more expensive than uint256 or any type that takes up a full
            // word because each write operation emits an extra SLOAD to first read the
            // slot's contents, replace the bits taken up by the boolean, and then write
            // back. This is the compiler's defense against contract upgrades and
            // pointer aliasing, and it cannot be disabled.
            // The values being non-zero value makes deployment a bit more expensive,
            // but in exchange the refund on every call to nonReentrant will be lower in
            // amount. Since refunds are capped to a percentage of the total
            // transaction's gas, it is best to keep them low in cases like this one, to
            // increase the likelihood of the full refund coming into effect.
            uint256 private constant _NOT_ENTERED = 1;
            uint256 private constant _ENTERED = 2;
            uint256 private _status;
            constructor() {
                _status = _NOT_ENTERED;
            }
            /**
             * @dev Prevents a contract from calling itself, directly or indirectly.
             * Calling a `nonReentrant` function from another `nonReentrant`
             * function is not supported. It is possible to prevent this from happening
             * by making the `nonReentrant` function external, and making it call a
             * `private` function that does the actual work.
             */
            modifier nonReentrant() {
                // On the first call to nonReentrant, _notEntered will be true
                require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                // Any calls to nonReentrant after this point will fail
                _status = _ENTERED;
                _;
                // By storing the original value once again, a refund is triggered (see
                // https://eips.ethereum.org/EIPS/eip-2200)
                _status = _NOT_ENTERED;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.0 (utils/Context.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Provides information about the current execution context, including the
         * sender of the transaction and its data. While these are generally available
         * via msg.sender and msg.data, they should not be accessed in such a direct
         * manner, since when dealing with meta-transactions the account sending and
         * paying for execution may not be the actual sender (as far as an application
         * is concerned).
         *
         * This contract is only required for intermediate, library-like contracts.
         */
        abstract contract Context {
            function _msgSender() internal view virtual returns (address) {
                return msg.sender;
            }
            function _msgData() internal view virtual returns (bytes calldata) {
                return msg.data;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.0 (utils/Address.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Collection of functions related to the address type
         */
        library Address {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize, which returns 0 for contracts in
                // construction, since the code is only stored at the end of the
                // constructor execution.
                uint256 size;
                assembly {
                    size := extcodesize(account)
                }
                return size > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
             * `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but also transferring `value` wei to `target`.
             *
             * Requirements:
             *
             * - the calling contract must have an ETH balance of at least `value`.
             * - the called Solidity function must be `payable`.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
            }
            /**
             * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
             * with `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(address(this).balance >= value, "Address: insufficient balance for call");
                require(isContract(target), "Address: call to non-contract");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "Address: low-level static call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                require(isContract(target), "Address: static call to non-contract");
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(isContract(target), "Address: delegate call to non-contract");
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    // Look for revert reason and bubble it up if present
                    if (returndata.length > 0) {
                        // The easiest way to bubble the revert reason is using memory via assembly
                        assembly {
                            let returndata_size := mload(returndata)
                            revert(add(32, returndata), returndata_size)
                        }
                    } else {
                        revert(errorMessage);
                    }
                }
            }
        }
        

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

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

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

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