ETH Price: $1,973.20 (+0.17%)

Transaction Decoder

Block:
22867010 at Jul-07-2025 11:26:35 AM +UTC
Transaction Fee:
0.000260614579473496 ETH $0.51
Gas Used:
121,364 Gas / 2.147379614 Gwei

Account State Difference:

  Address   Before After State Difference Code
0x83FD6c3F...63B1bD601
0.643385706268285313 Eth
Nonce: 13
0.643125091688811817 Eth
Nonce: 14
0.000260614579473496
(BuilderNet)
44.084248870564968529 Eth44.084369741931258841 Eth0.000120871366290312

Execution Trace

ETH 0.533039439011993909 Disperse.disperseEther( recipients=[0x42A93A9F5CFDa54716c414b6EAF07Cf512F46eAD, 0xE68badDE25D8389ae4b96962AC526D113f3BaC9D, 0x08EC37e2eB451AB6Fb29fC14d215b0AeeF170040, 0xD19d8Ee0a736bF643F53E3Dc5489aC94e947A482, 0x388C818CA8B9251b393131C08a736A67ccB19297, 0x34842c43e655779a86e890e2b56D09Bc477a1CE3, 0x0e33b1c214463062753aD849a28E54667e0c87c2, 0x22eEC85ba6a5cD97eAd4728eA1c69e1D9c6fa778, 0x6bE457e04092B28865E0cBa84E3b2CFa0f871E67, 0x12eE6B0ae0504BCccD431BD2bf5Bf73Bfb6cF1eA], values=[55222838581299032, 103831289471389895, 202977688816727139, 28420913091188855, 40622588825854396, 23907470291313878, 22172277318331899, 15096530516603108, 31378121868683515, 9409720230602192] )
  • ETH 0.055222838581299032 Fee Recipient: 0x42A...eAD.CALL( )
  • ETH 0.103831289471389895 0xe68badde25d8389ae4b96962ac526d113f3bac9d.CALL( )
  • ETH 0.202977688816727139 0x08ec37e2eb451ab6fb29fc14d215b0aeef170040.CALL( )
  • ETH 0.028420913091188855 NXVProxy.CALL( )
    • ETH 0.028420913091188855 NXV.DELEGATECALL( )
    • ETH 0.040622588825854396 LidoExecutionLayerRewardsVault.CALL( )
    • ETH 0.023907470291313878 Fee Recipient: 0x3484...ce3.CALL( )
    • ETH 0.022172277318331899 Fee Recipient: 0x0e33...7c2.CALL( )
    • ETH 0.015096530516603108 TransparentUpgradeableProxy.CALL( )
      • ETH 0.015096530516603108 RewardHandler.DELEGATECALL( )
        File 1 of 6: Disperse
        pragma solidity ^0.4.25;
        
        
        interface IERC20 {
            function transfer(address to, uint256 value) external returns (bool);
            function transferFrom(address from, address to, uint256 value) external returns (bool);
        }
        
        
        contract Disperse {
            function disperseEther(address[] recipients, uint256[] values) external payable {
                for (uint256 i = 0; i < recipients.length; i++)
                    recipients[i].transfer(values[i]);
                uint256 balance = address(this).balance;
                if (balance > 0)
                    msg.sender.transfer(balance);
            }
        
            function disperseToken(IERC20 token, address[] recipients, uint256[] values) external {
                uint256 total = 0;
                for (uint256 i = 0; i < recipients.length; i++)
                    total += values[i];
                require(token.transferFrom(msg.sender, address(this), total));
                for (i = 0; i < recipients.length; i++)
                    require(token.transfer(recipients[i], values[i]));
            }
        
            function disperseTokenSimple(IERC20 token, address[] recipients, uint256[] values) external {
                for (uint256 i = 0; i < recipients.length; i++)
                    require(token.transferFrom(msg.sender, recipients[i], values[i]));
            }
        }

        File 2 of 6: NXVProxy
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        
        /**
         * @title IProxy - Helper interface to access the singleton address of the Proxy on-chain.
         * @author Richard Meissner - @rmeissner
         */
        interface IProxy {
            function masterCopy() external view returns (address);
        }
        
        /**
         * @title NXVProxy - Generic proxy contract allows to execute all transactions applying the code of a master contract.
         * @author Stefan George - <stefan@gnosis.io>
         * @author Richard Meissner - <richard@gnosis.io>
         */
        contract NXVProxy {
            // Singleton always needs to be first declared variable, to ensure that it is at the same location in the contracts to which calls are delegated.
            // To reduce deployment costs this variable is internal and needs to be retrieved via `getStorageAt`.
            address internal singleton;
        
            /**
             * @notice Constructor function sets address of singleton contract.
             * @param _singleton Singleton address.
             */
            constructor(address _singleton) {
                require(_singleton != address(0), "Invalid singleton address provided");
                singleton = _singleton;
            }
        
            /// @dev Fallback function forwards all transactions and returns all received return data.
            fallback() external payable {
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    let _singleton := and(sload(0), 0xffffffffffffffffffffffffffffffffffffffff)
                    // 0xa619486e == keccak("masterCopy()"). The value is right padded to 32-bytes with 0s
                    if eq(calldataload(0), 0xa619486e00000000000000000000000000000000000000000000000000000000) {
                        mstore(0, _singleton)
                        return(0, 0x20)
                    }
                    calldatacopy(0, 0, calldatasize())
                    let success := delegatecall(gas(), _singleton, 0, calldatasize(), 0, 0)
                    returndatacopy(0, 0, returndatasize())
                    if eq(success, 0) {
                        revert(0, returndatasize())
                    }
                    return(0, returndatasize())
                }
            }
        }

        File 3 of 6: NXV
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import {Executor} from "./base/Executor.sol";
        import {OwnerManager} from "./base/OwnerManager.sol";
        import {FallbackManager} from "./base/FallbackManager.sol";
        import {NativeCurrencyPaymentFallback} from "./common/NativeCurrencyPaymentFallback.sol";
        import {Singleton} from "./common/Singleton.sol";
        import {SignatureDecoder} from "./common/SignatureDecoder.sol";
        import {SecuredTokenTransfer} from "./common/SecuredTokenTransfer.sol";
        import {StorageAccessible} from "./common/StorageAccessible.sol";
        import {Enum} from "./common/Enum.sol";
        import {ISignatureValidator, ISignatureValidatorConstants} from "./interfaces/ISignatureValidator.sol";
        import {SafeMath} from "./external/SafeMath.sol";
        /**
         * @title NXV - A multisignature wallet with support for confirmations using signed messages based on EIP-712.
         * @dev Most important concepts:
         *      - Threshold: Number of required confirmations for a NXV transaction.
         *      - Owners: List of addresses that control the NXV. They are the only ones that can add/remove owners, change the threshold and
         *        approve transactions. Managed in `OwnerManager`.
         *      - Transaction Hash: Hash of a transaction is calculated using the EIP-712 typed structured data hashing scheme.
         *      - Nonce: Each transaction should have a different nonce to prevent replay attacks.
         *      - Signature: A valid signature of an owner of the NXV for a transaction hash.
         *      - Fallback: Fallback handler is a contract that can provide additional read-only functional for NXV. Managed in `FallbackManager`.
         * @author Stefan George - @Georgi87
         * @author Richard Meissner - @rmeissner
         */
        contract NXV is
            Singleton,
            NativeCurrencyPaymentFallback,
            Executor,
            OwnerManager,
            SignatureDecoder,
            ISignatureValidatorConstants,
            FallbackManager,
            StorageAccessible
        {
            using SafeMath for uint256;
            string public constant VERSION = "1.0.0";
            /*
             *  Constants
             */
            // bytes32 public DOMAIN_SEPARATOR;
            bytes32 private constant EIP712DOMAIN_TYPEHASH = keccak256("EIP712Domain(string name,uint256 chainId,address verifyingContract)");
            bytes32 private constant TRANSACTION_TYPEHASH = keccak256("Transaction(address to,uint256 value,bytes data,uint8 operation,uint256 nonce)");
            /*
             *  Events
             */
            event NXVSetup(address indexed initiator, address[] owners, uint256 threshold, address fallbackHandler);
            event ExecutionSuccess(bytes32 indexed txHash, uint256 indexed nonce);
            event ExecutionFailure(bytes32 indexed txHash, uint256 indexed nonce);
            /*
             *  Storage
             */
            mapping(uint256 => bool) public txNonces;
            // Mapping to keep track of all message hashes that have been approved by ALL REQUIRED owners
            mapping(bytes32 => uint256) public signedMessages;
            // This constructor ensures that this contract can only be used as a singleton for Proxy contracts
            constructor() {
                /**
                 * By setting the threshold it is not possible to call setup anymore,
                 * so we create a NXV with 0 owners and threshold 1.
                 * This is an unusable NXV, perfect for the singleton
                 */
                threshold = 1;
            }
            /**
             * @notice Sets an initial storage of the NXV contract.
             * @dev This method can only be called once.
             *      If a proxy was created without setting up, anyone can call setup and claim the proxy.
             * @param _owners List of NXV owners.
             * @param _threshold Number of required confirmations for a NXV transaction.
             * @param fallbackHandler Handler for fallback calls to this contract
             */
            function setup(
                address[] calldata _owners,
                uint256 _threshold,
                address fallbackHandler
            ) external {
                // setupOwners checks if the Threshold is already set, therefore preventing that this method is called twice
                setupOwners(_owners, _threshold);
                if (fallbackHandler != address(0)) internalSetFallbackHandler(fallbackHandler);
                emit NXVSetup(msg.sender, _owners, _threshold, fallbackHandler);
            }
            /**
             * @notice Executes a `operation` {0: Call, 1: DelegateCall}} transaction to `to` with `value` (Native Currency)
             * @param to to address of NXV transaction.
             * @param value Ether value of NXV transaction.
             * @param data Data payload of NXV transaction.
             * @param operation Operation type of NXV transaction.
             * @param nonce Transaction nonce
             * @param signatures Signature data that should be verified.
             *                   Can be packed ECDSA signature ({bytes32 r}{bytes32 s}{uint8 v}), contract signature (EIP-1271) or approved hash.
             * @return success Boolean indicating transaction's success.
             */
            function execTransaction(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation,
                uint256 nonce,
                bytes memory signatures
            ) public payable virtual returns (bool success) {
                // require(signatures.length >= threshold, "invalid signature data length");
                // "txHash" is the unique hash of transaction data
                bytes32 txHash = getTransactionHash(to, value, data, operation, nonce);
                // two identical nonce only allow one to be executed
                // uint256 nonce = nonce;
                require(!txNonces[nonce], "tx-nonce-exist");
                checkSignatures(txHash, "", signatures);
                txNonces[nonce] = true;
                success = execute(to, value, data, operation, (gasleft() - 2500));
                if (success) {
                    emit ExecutionSuccess(txHash, nonce);
                } else {
                    emit ExecutionFailure(txHash, nonce);
                }
            }
            /**
             * @notice Checks whether the signature provided is valid for the provided data and hash. Reverts otherwise.
             * @param txHash Hash of the data (could be either a message hash or transaction hash)
             * @param data That should be signed (this is passed to an external validator contract)
             * @param signatures Signature data that should be verified.
             *                   Can be packed ECDSA signature ({bytes32 r}{bytes32 s}{uint8 v}), contract signature (EIP-1271) or approved hash.
             */
            function checkSignatures(bytes32 txHash, bytes memory data, bytes memory signatures) public view {
                // Load threshold to avoid multiple storage loads
                uint256 _threshold = threshold;
                // Check that a threshold is set
                require(_threshold > 0, "Threshold needs defined");
                checkNSignatures(txHash, data, signatures, _threshold);
            }
            /**
             * @notice Checks whether the signature provided is valid for the provided data and hash. Reverts otherwise.
             * @dev Since the EIP-1271 does an external call, be mindful of reentrancy attacks.
             * @param txHash Hash of the data (could be either a message hash or transaction hash)
             * @param signatures Signature data that should be verified.
             *                   Can be packed ECDSA signature ({bytes32 r}{bytes32 s}{uint8 v}), contract signature (EIP-1271) or approved hash.
             * @param requiredSignatures Amount of required valid signatures.
             */
            function checkNSignatures(bytes32 txHash, bytes memory /* data */, bytes memory signatures, uint256 requiredSignatures) public view {
                // Check that the provided signature data is not too short
                require(signatures.length >= requiredSignatures * 65, "invalid sig length");
                // There cannot be an owner with address 0.
                address lastOwner = address(0);
                address currentOwner;
                uint8 v;
                bytes32 r;
                bytes32 s;
                uint256 i;
                for(i = 0; i < requiredSignatures; i++) {
                    (v, r, s) = signatureSplit(signatures, i);
                    currentOwner = ecrecover(txHash, v, r, s);
                    // to save gas, need signature sorted
                    require(currentOwner > lastOwner && owners[currentOwner] != address(0) && currentOwner != SENTINEL_OWNERS, "error-sig");
                    lastOwner = currentOwner;
                }
            }
            /**
             * @notice Returns the ID of the chain the contract is currently deployed on.
             * @return The ID of the current chain as a uint256.
             */
            function getChainId() public view returns (uint256) {
                uint256 id;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    id := chainid()
                }
                return id;
            }
            /**
             * @dev Returns the domain separator for this contract, as defined in the EIP-712 standard.
             * @return bytes32 The domain separator hash.
             */
            function domainSeparator() public view returns (bytes32) {
                return keccak256(
                    abi.encode(
                        EIP712DOMAIN_TYPEHASH,
                        keccak256("NXVWallet"), // name
                        getChainId(),
                        address(this)
                    )
                );
            }
            /**
             * @notice Returns the pre-image of the transaction hash (see getTransactionHash).
             * @param to to address.
             * @param value Ether value.
             * @param data Data payload.
             * @param operation Operation type.
             * @param _nonce Transaction nonce.
             * @return Transaction hash bytes.
             */
            function encodeTransactionData(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation,
                uint256 _nonce
            ) private view returns (bytes memory) {
                bytes32 txHash = keccak256(
                    abi.encode(
                        TRANSACTION_TYPEHASH,
                        to,
                        value,
                        keccak256(data),
                        operation,
                        _nonce
                    )
                );
                return abi.encodePacked(bytes1(0x19), bytes1(0x01), domainSeparator(), txHash);
            }
            /**
             * @notice Returns transaction hash to be signed by owners.
             * @param to to address.
             * @param value Ether value.
             * @param data Data payload.
             * @param operation Operation type.
             * @param _nonce Transaction nonce.
             * @return Transaction hash.
             */
            function getTransactionHash(
                address to,
                uint256 value,
                bytes calldata data,
                Enum.Operation operation,
                uint256 _nonce
            ) public view returns (bytes32) {
                return keccak256(encodeTransactionData(to, value, data, operation, _nonce));
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import {Enum} from "../common/Enum.sol";
        /**
         * @title Executor - A contract that can execute transactions
         * @author Richard Meissner - @rmeissner
         */
        abstract contract Executor {
            /**
             * @notice Executes either a delegatecall or a call with provided parameters.
             * @dev This method doesn't perform any sanity check of the transaction, such as:
             *      - if the contract at `to` address has code or not
             *      It is the responsibility of the caller to perform such checks.
             * @param to Destination address.
             * @param value Ether value.
             * @param data Data payload.
             * @param operation Operation type.
             * @return success boolean flag indicating if the call succeeded.
             */
            function execute(
                address to,
                uint256 value,
                bytes memory data,
                Enum.Operation operation,
                uint256 txGas
            ) internal returns (bool success) {
                if (operation == Enum.Operation.DelegateCall) {
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        success := delegatecall(txGas, to, add(data, 0x20), mload(data), 0, 0)
                    }
                } else {
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        success := call(txGas, to, value, add(data, 0x20), mload(data), 0, 0)
                    }
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import {SelfAuthorized} from "../common/SelfAuthorized.sol";
        /**
         * @title Fallback Manager - A contract managing fallback calls made to this contract
         * @author Richard Meissner - @rmeissner
         */
        abstract contract FallbackManager is SelfAuthorized {
            event ChangedFallbackHandler(address indexed handler);
            // keccak256("fallback_manager.handler.address")
            bytes32 internal constant FALLBACK_HANDLER_STORAGE_SLOT = 0x6c9a6c4a39284e37ed1cf53d337577d14212a4870fb976a4366c693b939918d5;
            /**
             *  @notice Internal function to set the fallback handler.
             *  @param handler contract to handle fallback calls.
             */
            function internalSetFallbackHandler(address handler) internal {
                /*
                    If a fallback handler is set to self, then the following attack vector is opened:
                    Imagine we have a function like this:
                    function withdraw() internal authorized {
                        withdrawalAddress.call.value(address(this).balance)("");
                    }
                    If the fallback method is triggered, the fallback handler appends the msg.sender address to the calldata and calls the fallback handler.
                    A potential attacker could call a Safe with the 3 bytes signature of a withdraw function. Since 3 bytes do not create a valid signature,
                    the call would end in a fallback handler. Since it appends the msg.sender address to the calldata, the attacker could craft an address 
                    where the first 3 bytes of the previous calldata + the first byte of the address make up a valid function signature. The subsequent call would result in unsanctioned access to Safe's internal protected methods.
                    For some reason, solidity matches the first 4 bytes of the calldata to a function signature, regardless if more data follow these 4 bytes.
                */
                require(handler != address(this), "Fallback handler cannot be self");
                bytes32 slot = FALLBACK_HANDLER_STORAGE_SLOT;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    sstore(slot, handler)
                }
            }
            /**
             * @notice Set Fallback Handler to `handler` for the Safe.
             * @dev Only fallback calls without value and with data will be forwarded.
             *      This can only be done via a Safe transaction.
             *      Cannot be set to the Safe itself.
             * @param handler contract to handle fallback calls.
             */
            function setFallbackHandler(address handler) public authorized {
                internalSetFallbackHandler(handler);
                emit ChangedFallbackHandler(handler);
            }
            // @notice Forwards all calls to the fallback handler if set. Returns 0 if no handler is set.
            // @dev Appends the non-padded caller address to the calldata to be optionally used in the handler
            //      The handler can make us of `HandlerContext.sol` to extract the address.
            //      This is done because in the next call frame the `msg.sender` will be FallbackManager's address
            //      and having the original caller address may enable additional verification scenarios.
            // solhint-disable-next-line payable-fallback,no-complex-fallback
            fallback() external {
                bytes32 slot = FALLBACK_HANDLER_STORAGE_SLOT;
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    let handler := sload(slot)
                    if iszero(handler) {
                        return(0, 0)
                    }
                    calldatacopy(0, 0, calldatasize())
                    // The msg.sender address is shifted to the left by 12 bytes to remove the padding
                    // Then the address without padding is stored right after the calldata
                    mstore(calldatasize(), shl(96, caller()))
                    // Add 20 bytes for the address appended add the end
                    let success := call(gas(), handler, 0, 0, add(calldatasize(), 20), 0, 0)
                    returndatacopy(0, 0, returndatasize())
                    if iszero(success) {
                        revert(0, returndatasize())
                    }
                    return(0, returndatasize())
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        import {SelfAuthorized} from "../common/SelfAuthorized.sol";
        /**
         * @title OwnerManager - Manages Safe owners and a threshold to authorize transactions.
         * @dev Uses a linked list to store the owners because the code generate by the solidity compiler
         *      is more efficient than using a dynamic array.
         * @author Stefan George - @Georgi87
         * @author Richard Meissner - @rmeissner
         */
        abstract contract OwnerManager is SelfAuthorized {
            event AddedOwner(address indexed owner);
            event RemovedOwner(address indexed owner);
            event ChangedThreshold(uint256 threshold);
            address internal constant SENTINEL_OWNERS = address(0x1);
            mapping(address => address) internal owners;
            uint256 internal ownerCount;
            uint256 internal threshold;
            /**
             * @notice Sets the initial storage of the contract.
             * @param _owners List of Safe owners.
             * @param _threshold Number of required confirmations for a Safe transaction.
             */
            function setupOwners(address[] memory _owners, uint256 _threshold) internal {
                // Threshold can only be 0 at initialization.
                // Check ensures that setup function can only be called once.
                require(threshold == 0, "Owners set up");
                // Validate that threshold is smaller than number of added owners.
                require(_threshold <= _owners.length, "Threshold exceed owner count");
                // There has to be at least one Safe owner.
                require(_threshold >= 1, "Threshold needs greater than 0");
                // Initializing Safe owners.
                address currentOwner = SENTINEL_OWNERS;
                for (uint256 i = 0; i < _owners.length; i++) {
                    // Owner address cannot be null.
                    address owner = _owners[i];
                    require(owner != address(0) && owner != SENTINEL_OWNERS && owner != address(this) && currentOwner != owner, "Invalid owner");
                    // No duplicate owners allowed.
                    require(owners[owner] == address(0), "Address is already owner");
                    owners[currentOwner] = owner;
                    currentOwner = owner;
                }
                owners[currentOwner] = SENTINEL_OWNERS;
                ownerCount = _owners.length;
                threshold = _threshold;
            }
            /**
             * @notice Adds the owner `owner` to the Safe and updates the threshold to `_threshold`.
             * @dev This can only be done via a Safe transaction.
             * @param owner New owner address.
             * @param _threshold New threshold.
             */
            function addOwnerWithThreshold(address owner, uint256 _threshold) public authorized {
                // Owner address cannot be null, the sentinel or the Safe itself.
                require(owner != address(0) && owner != SENTINEL_OWNERS && owner != address(this), "Invalid owner");
                // No duplicate owners allowed.
                require(owners[owner] == address(0), "Address is already owner");
                owners[owner] = owners[SENTINEL_OWNERS];
                owners[SENTINEL_OWNERS] = owner;
                ownerCount++;
                emit AddedOwner(owner);
                // Change threshold if threshold was changed.
                if (threshold != _threshold) changeThreshold(_threshold);
            }
            /**
             * @notice Removes the owner `owner` from the Safe and updates the threshold to `_threshold`.
             * @dev This can only be done via a Safe transaction.
             * @param prevOwner Owner that pointed to the owner to be removed in the linked list
             * @param owner Owner address to be removed.
             * @param _threshold New threshold.
             */
            function removeOwner(address prevOwner, address owner, uint256 _threshold) public authorized {
                // Only allow to remove an owner, if threshold can still be reached.
                require(ownerCount - 1 >= _threshold, "Threshold exceed owner count");
                // Validate owner address and check that it corresponds to owner index.
                require(owner != address(0) && owner != SENTINEL_OWNERS, "Invalid owner");
                require(owners[prevOwner] == owner, "Invalid prevOwner, owner");
                owners[prevOwner] = owners[owner];
                owners[owner] = address(0);
                ownerCount--;
                emit RemovedOwner(owner);
                // Change threshold if threshold was changed.
                if (threshold != _threshold) changeThreshold(_threshold);
            }
            /**
             * @notice Replaces the owner `oldOwner` in the Safe with `newOwner`.
             * @dev This can only be done via a Safe transaction.
             * @param prevOwner Owner that pointed to the owner to be replaced in the linked list
             * @param oldOwner Owner address to be replaced.
             * @param newOwner New owner address.
             */
            function swapOwner(address prevOwner, address oldOwner, address newOwner) public authorized {
                // Owner address cannot be null, the sentinel or the Safe itself.
                require(newOwner != address(0) && newOwner != SENTINEL_OWNERS && newOwner != address(this), "Invalid owner");
                // No duplicate owners allowed.
                require(owners[newOwner] == address(0), "Address is already owner");
                // Validate oldOwner address and check that it corresponds to owner index.
                require(oldOwner != address(0) && oldOwner != SENTINEL_OWNERS, "Invalid owner");
                require(owners[prevOwner] == oldOwner, "Invalid prevOwner, owner");
                owners[newOwner] = owners[oldOwner];
                owners[prevOwner] = newOwner;
                owners[oldOwner] = address(0);
                emit RemovedOwner(oldOwner);
                emit AddedOwner(newOwner);
            }
            /**
             * @notice Changes the threshold of the Safe to `_threshold`.
             * @dev This can only be done via a Safe transaction.
             * @param _threshold New threshold.
             */
            function changeThreshold(uint256 _threshold) public authorized {
                // Validate that threshold is smaller than number of owners.
                require(_threshold <= ownerCount, "Threshold exceed owner count");
                // There has to be at least one Safe owner.
                require(_threshold >= 1, "Threshold needs greater than 0");
                threshold = _threshold;
                emit ChangedThreshold(threshold);
            }
            /**
             * @notice Returns the number of required confirmations for a Safe transaction aka the threshold.
             * @return Threshold number.
             */
            function getThreshold() public view returns (uint256) {
                return threshold;
            }
            /**
             * @notice Returns if `owner` is an owner of the Safe.
             * @return Boolean if owner is an owner of the Safe.
             */
            function isOwner(address owner) public view returns (bool) {
                return owner != SENTINEL_OWNERS && owners[owner] != address(0);
            }
            /**
             * @notice Returns a list of Safe owners.
             * @return Array of Safe owners.
             */
            function getOwners() public view returns (address[] memory) {
                address[] memory array = new address[](ownerCount);
                // populate return array
                uint256 index = 0;
                address currentOwner = owners[SENTINEL_OWNERS];
                while (currentOwner != SENTINEL_OWNERS) {
                    array[index] = currentOwner;
                    currentOwner = owners[currentOwner];
                    index++;
                }
                return array;
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title Enum - Collection of enums used in Safe contracts.
         * @author Richard Meissner - @rmeissner
         */
        abstract contract Enum {
            enum Operation {
                Call,
                DelegateCall
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title NativeCurrencyPaymentFallback - A contract that has a fallback to accept native currency payments.
         * @author Richard Meissner - @rmeissner
         */
        abstract contract NativeCurrencyPaymentFallback {
            event NXVReceived(address indexed sender, uint256 value);
            /**
             * @notice Receive function accepts native currency transactions.
             * @dev Emits an event with sender and received value.
             */
            receive() external payable {
                emit NXVReceived(msg.sender, msg.value);
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title SecuredTokenTransfer - Secure token transfer.
         * @author Richard Meissner - @rmeissner
         */
        abstract contract SecuredTokenTransfer {
            /**
             * @notice Transfers a token and returns a boolean if it was a success
             * @dev It checks the return data of the transfer call and returns true if the transfer was successful.
             *      It doesn't check if the `token` address is a contract or not.
             * @param token Token that should be transferred
             * @param receiver Receiver to whom the token should be transferred
             * @param amount The amount of tokens that should be transferred
             * @return transferred Returns true if the transfer was successful
             */
            function transferToken(address token, address receiver, uint256 amount) internal returns (bool transferred) {
                // 0xa9059cbb - keccack("transfer(address,uint256)")
                bytes memory data = abi.encodeWithSelector(0xa9059cbb, receiver, amount);
                // solhint-disable-next-line no-inline-assembly
                assembly {
                    // We write the return value to scratch space.
                    // See https://docs.soliditylang.org/en/v0.7.6/internals/layout_in_memory.html#layout-in-memory
                    let success := call(sub(gas(), 10000), token, 0, add(data, 0x20), mload(data), 0, 0x20)
                    switch returndatasize()
                    case 0 {
                        transferred := success
                    }
                    case 0x20 {
                        transferred := iszero(or(iszero(success), iszero(mload(0))))
                    }
                    default {
                        transferred := 0
                    }
                }
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title SelfAuthorized - Authorizes current contract to perform actions to itself.
         * @author Richard Meissner - @rmeissner
         */
        abstract contract SelfAuthorized {
            function requireSelfCall() private view {
                require(msg.sender == address(this), "Only be called from this contract");
            }
            modifier authorized() {
                // Modifiers are copied around during compilation. This is a function call as it minimized the bytecode size
                requireSelfCall();
                _;
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title SignatureDecoder - Decodes signatures encoded as bytes
         * @author Richard Meissner - @rmeissner
         */
        abstract contract SignatureDecoder {
            /**
             * @notice Splits signature bytes into `uint8 v, bytes32 r, bytes32 s`.
             * @dev Make sure to perform a bounds check for @param pos, to avoid out of bounds access on @param signatures
             *      The signature format is a compact form of {bytes32 r}{bytes32 s}{uint8 v}
             *      Compact means uint8 is not padded to 32 bytes.
             * @param pos Which signature to read.
             *            A prior bounds check of this parameter should be performed, to avoid out of bounds access.
             * @param signatures Concatenated {r, s, v} signatures.
             * @return v Recovery ID or Safe signature type.
             * @return r Output value r of the signature.
             * @return s Output value s of the signature.
             */
            function signatureSplit(bytes memory signatures, uint256 pos) internal pure returns (uint8 v, bytes32 r, bytes32 s) {
                /* solhint-disable no-inline-assembly */
                /// @solidity memory-safe-assembly
                assembly {
                    let signaturePos := mul(0x41, pos)
                    r := mload(add(signatures, add(signaturePos, 0x20)))
                    s := mload(add(signatures, add(signaturePos, 0x40)))
                    v := byte(0, mload(add(signatures, add(signaturePos, 0x60))))
                }
                /* solhint-enable no-inline-assembly */
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title Singleton - Base for singleton contracts (should always be the first super contract)
         *        This contract is tightly coupled to our proxy contract (see `proxies/SafeProxy.sol`)
         * @author Richard Meissner - @rmeissner
         */
        abstract contract Singleton {
            // singleton always has to be the first declared variable to ensure the same location as in the Proxy contract.
            // It should also always be ensured the address is stored alone (uses a full word)
            address private singleton;
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title StorageAccessible - A generic base contract that allows callers to access all internal storage.
         * @notice See https://github.com/gnosis/util-contracts/blob/bb5fe5fb5df6d8400998094fb1b32a178a47c3a1/contracts/StorageAccessible.sol
         *         It removes a method from the original contract not needed for the Safe contracts.
         * @author Gnosis Developers
         */
        abstract contract StorageAccessible {
            /**
             * @notice Reads `length` bytes of storage in the currents contract
             * @param offset - the offset in the current contract's storage in words to start reading from
             * @param length - the number of words (32 bytes) of data to read
             * @return the bytes that were read.
             */
            function getStorageAt(uint256 offset, uint256 length) public view returns (bytes memory) {
                bytes memory result = new bytes(length * 32);
                for (uint256 index = 0; index < length; index++) {
                    /* solhint-disable no-inline-assembly */
                    /// @solidity memory-safe-assembly
                    assembly {
                        let word := sload(add(offset, index))
                        mstore(add(add(result, 0x20), mul(index, 0x20)), word)
                    }
                    /* solhint-enable no-inline-assembly */
                }
                return result;
            }
            /**
             * @dev Performs a delegatecall on a targetContract in the context of self.
             * Internally reverts execution to avoid side effects (making it static).
             *
             * This method reverts with data equal to `abi.encode(bool(success), bytes(response))`.
             * Specifically, the `returndata` after a call to this method will be:
             * `success:bool || response.length:uint256 || response:bytes`.
             *
             * @param targetContract Address of the contract containing the code to execute.
             * @param calldataPayload Calldata that should be sent to the target contract (encoded method name and arguments).
             */
            function simulateAndRevert(address targetContract, bytes memory calldataPayload) external {
                /* solhint-disable no-inline-assembly */
                /// @solidity memory-safe-assembly
                assembly {
                    let success := delegatecall(gas(), targetContract, add(calldataPayload, 0x20), mload(calldataPayload), 0, 0)
                    // Load free memory location
                    let ptr := mload(0x40)
                    mstore(ptr, success)
                    mstore(add(ptr, 0x20), returndatasize())
                    returndatacopy(add(ptr, 0x40), 0, returndatasize())
                    revert(ptr, add(returndatasize(), 0x40))
                }
                /* solhint-enable no-inline-assembly */
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        pragma solidity >=0.7.0 <0.9.0;
        /**
         * @title SafeMath
         * @notice Math operations with safety checks that revert on error (overflow/underflow)
         */
        library SafeMath {
            /**
             * @notice Multiplies two numbers, reverts on overflow.
             * @param a First number
             * @param b Second number
             * @return Product of a and b
             */
            function mul(uint256 a, uint256 b) internal pure returns (uint256) {
                // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
                // benefit is lost if 'b' is also tested.
                // See: https://github.com/OpenZeppelin/openzeppelin-solidity/pull/522
                if (a == 0) {
                    return 0;
                }
                uint256 c = a * b;
                require(c / a == b);
                return c;
            }
            /**
             * @notice Subtracts two numbers, reverts on overflow (i.e. if subtrahend is greater than minuend).
             * @param a First number
             * @param b Second number
             * @return Difference of a and b
             */
            function sub(uint256 a, uint256 b) internal pure returns (uint256) {
                require(b <= a);
                uint256 c = a - b;
                return c;
            }
            /**
             * @notice Adds two numbers, reverts on overflow.
             * @param a First number
             * @param b Second number
             * @return Sum of a and b
             */
            function add(uint256 a, uint256 b) internal pure returns (uint256) {
                uint256 c = a + b;
                require(c >= a);
                return c;
            }
            /**
             * @notice Returns the largest of two numbers.
             * @param a First number
             * @param b Second number
             * @return Largest of a and b
             */
            function max(uint256 a, uint256 b) internal pure returns (uint256) {
                return a >= b ? a : b;
            }
        }
        // SPDX-License-Identifier: LGPL-3.0-only
        /* solhint-disable one-contract-per-file */
        pragma solidity >=0.7.0 <0.9.0;
        contract ISignatureValidatorConstants {
            // bytes4(keccak256("isValidSignature(bytes32,bytes)")
            bytes4 internal constant EIP1271_MAGIC_VALUE = 0x1626ba7e;
        }
        abstract contract ISignatureValidator is ISignatureValidatorConstants {
            /**
             * @notice EIP1271 method to validate a signature.
             * @param _hash Hash of the data signed on the behalf of address(this).
             * @param _signature Signature byte array associated with _data.
             *
             * MUST return the bytes4 magic value 0x1626ba7e when function passes.
             * MUST NOT modify state (using STATICCALL for solc < 0.5, view modifier for solc > 0.5)
             * MUST allow external calls
             */
            function isValidSignature(bytes32 _hash, bytes memory _signature) external view virtual returns (bytes4);
        }
        

        File 4 of 6: LidoExecutionLayerRewardsVault
        // SPDX-FileCopyrightText: 2021 Lido <info@lido.fi>
        // SPDX-License-Identifier: GPL-3.0
        /* See contracts/COMPILERS.md */
        pragma solidity 0.8.9;
        import "@openzeppelin/contracts-v4.4/token/ERC20/IERC20.sol";
        import "@openzeppelin/contracts-v4.4/token/ERC721/IERC721.sol";
        import "@openzeppelin/contracts-v4.4/token/ERC20/utils/SafeERC20.sol";
        interface ILido {
            /**
              * @notice A payable function supposed to be called only by LidoExecLayerRewardsVault contract
              * @dev We need a dedicated function because funds received by the default payable function
              * are treated as a user deposit
              */
            function receiveELRewards() external payable;
        }
        /**
         * @title A vault for temporary storage of execution layer rewards (MEV and tx priority fee)
         */
        contract LidoExecutionLayerRewardsVault {
            using SafeERC20 for IERC20;
            address public immutable LIDO;
            address public immutable TREASURY;
            /**
              * Emitted when the ERC20 `token` recovered (i.e. transferred)
              * to the Lido treasury address by `requestedBy` sender.
              */
            event ERC20Recovered(
                address indexed requestedBy,
                address indexed token,
                uint256 amount
            );
            /**
              * Emitted when the ERC721-compatible `token` (NFT) recovered (i.e. transferred)
              * to the Lido treasury address by `requestedBy` sender.
              */
            event ERC721Recovered(
                address indexed requestedBy,
                address indexed token,
                uint256 tokenId
            );
            /**
              * Emitted when the vault received ETH
              */
            event ETHReceived(
                uint256 amount
            );
            /**
              * Ctor
              *
              * @param _lido the Lido token (stETH) address
              * @param _treasury the Lido treasury address (see ERC20/ERC721-recovery interfaces)
              */
            constructor(address _lido, address _treasury) {
                require(_lido != address(0), "LIDO_ZERO_ADDRESS");
                require(_treasury != address(0), "TREASURY_ZERO_ADDRESS");
                LIDO = _lido;
                TREASURY = _treasury;
            }
            /**
              * @notice Allows the contract to receive ETH
              * @dev execution layer rewards may be sent as plain ETH transfers
              */
            receive() external payable {
                emit ETHReceived(msg.value);
            }
            /**
              * @notice Withdraw all accumulated rewards to Lido contract
              * @dev Can be called only by the Lido contract
              * @param _maxAmount Max amount of ETH to withdraw
              * @return amount of funds received as execution layer rewards (in wei)
              */
            function withdrawRewards(uint256 _maxAmount) external returns (uint256 amount) {
                require(msg.sender == LIDO, "ONLY_LIDO_CAN_WITHDRAW");
                uint256 balance = address(this).balance;
                amount = (balance > _maxAmount) ? _maxAmount : balance;
                if (amount > 0) {
                    ILido(LIDO).receiveELRewards{value: amount}();
                }
                return amount;
            }
            /**
              * Transfers a given `_amount` of an ERC20-token (defined by the `_token` contract address)
              * currently belonging to the burner contract address to the Lido treasury address.
              *
              * @param _token an ERC20-compatible token
              * @param _amount token amount
              */
            function recoverERC20(address _token, uint256 _amount) external {
                require(_amount > 0, "ZERO_RECOVERY_AMOUNT");
                emit ERC20Recovered(msg.sender, _token, _amount);
                IERC20(_token).safeTransfer(TREASURY, _amount);
            }
            /**
              * Transfers a given token_id of an ERC721-compatible NFT (defined by the token contract address)
              * currently belonging to the burner contract address to the Lido treasury address.
              *
              * @param _token an ERC721-compatible token
              * @param _tokenId minted token id
              */
            function recoverERC721(address _token, uint256 _tokenId) external {
                emit ERC721Recovered(msg.sender, _token, _tokenId);
                IERC721(_token).transferFrom(address(this), TREASURY, _tokenId);
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (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.1 (token/ERC721/IERC721.sol)
        pragma solidity ^0.8.0;
        import "../../utils/introspection/IERC165.sol";
        /**
         * @dev Required interface of an ERC721 compliant contract.
         */
        interface IERC721 is IERC165 {
            /**
             * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
             */
            event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
             */
            event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
            /**
             * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
             */
            event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
            /**
             * @dev Returns the number of tokens in ``owner``'s account.
             */
            function balanceOf(address owner) external view returns (uint256 balance);
            /**
             * @dev Returns the owner of the `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function ownerOf(uint256 tokenId) external view returns (address owner);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
             * are aware of the ERC721 protocol to prevent tokens from being forever locked.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Transfers `tokenId` token from `from` to `to`.
             *
             * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             *
             * Emits a {Transfer} event.
             */
            function transferFrom(
                address from,
                address to,
                uint256 tokenId
            ) external;
            /**
             * @dev Gives permission to `to` to transfer `tokenId` token to another account.
             * The approval is cleared when the token is transferred.
             *
             * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
             *
             * Requirements:
             *
             * - The caller must own the token or be an approved operator.
             * - `tokenId` must exist.
             *
             * Emits an {Approval} event.
             */
            function approve(address to, uint256 tokenId) external;
            /**
             * @dev Returns the account approved for `tokenId` token.
             *
             * Requirements:
             *
             * - `tokenId` must exist.
             */
            function getApproved(uint256 tokenId) external view returns (address operator);
            /**
             * @dev Approve or remove `operator` as an operator for the caller.
             * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
             *
             * Requirements:
             *
             * - The `operator` cannot be the caller.
             *
             * Emits an {ApprovalForAll} event.
             */
            function setApprovalForAll(address operator, bool _approved) external;
            /**
             * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
             *
             * See {setApprovalForAll}
             */
            function isApprovedForAll(address owner, address operator) external view returns (bool);
            /**
             * @dev Safely transfers `tokenId` token from `from` to `to`.
             *
             * Requirements:
             *
             * - `from` cannot be the zero address.
             * - `to` cannot be the zero address.
             * - `tokenId` token must exist and be owned by `from`.
             * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
             * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
             *
             * Emits a {Transfer} event.
             */
            function safeTransferFrom(
                address from,
                address to,
                uint256 tokenId,
                bytes calldata data
            ) external;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (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.1 (utils/introspection/IERC165.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Interface of the ERC165 standard, as defined in the
         * https://eips.ethereum.org/EIPS/eip-165[EIP].
         *
         * Implementers can declare support of contract interfaces, which can then be
         * queried by others ({ERC165Checker}).
         *
         * For an implementation, see {ERC165}.
         */
        interface IERC165 {
            /**
             * @dev Returns true if this contract implements the interface defined by
             * `interfaceId`. See the corresponding
             * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
             * to learn more about how these ids are created.
             *
             * This function call must use less than 30 000 gas.
             */
            function supportsInterface(bytes4 interfaceId) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (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 5 of 6: TransparentUpgradeableProxy
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0-rc.0) (interfaces/draft-IERC1822.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
         * proxy whose upgrades are fully controlled by the current implementation.
         */
        interface IERC1822Proxiable {
            /**
             * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
             * address.
             *
             * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
             * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
             * function revert if invoked through a proxy.
             */
            function proxiableUUID() external view returns (bytes32);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/ERC1967/ERC1967Proxy.sol)
        pragma solidity ^0.8.0;
        import "../Proxy.sol";
        import "./ERC1967Upgrade.sol";
        /**
         * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
         * implementation address that can be changed. This address is stored in storage in the location specified by
         * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
         * implementation behind the proxy.
         */
        contract ERC1967Proxy is Proxy, ERC1967Upgrade {
            /**
             * @dev Initializes the upgradeable proxy with an initial implementation specified by `_logic`.
             *
             * If `_data` is nonempty, it's used as data in a delegate call to `_logic`. This will typically be an encoded
             * function call, and allows initializating the storage of the proxy like a Solidity constructor.
             */
            constructor(address _logic, bytes memory _data) payable {
                assert(_IMPLEMENTATION_SLOT == bytes32(uint256(keccak256("eip1967.proxy.implementation")) - 1));
                _upgradeToAndCall(_logic, _data, false);
            }
            /**
             * @dev Returns the current implementation address.
             */
            function _implementation() internal view virtual override returns (address impl) {
                return ERC1967Upgrade._getImplementation();
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/ERC1967/ERC1967Upgrade.sol)
        pragma solidity ^0.8.2;
        import "../beacon/IBeacon.sol";
        import "../../interfaces/draft-IERC1822.sol";
        import "../../utils/Address.sol";
        import "../../utils/StorageSlot.sol";
        /**
         * @dev This abstract contract provides getters and event emitting update functions for
         * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
         *
         * _Available since v4.1._
         *
         * @custom:oz-upgrades-unsafe-allow delegatecall
         */
        abstract contract ERC1967Upgrade {
            // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
            bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
            /**
             * @dev Storage slot with the address of the current implementation.
             * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
             * validated in the constructor.
             */
            bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
            /**
             * @dev Emitted when the implementation is upgraded.
             */
            event Upgraded(address indexed implementation);
            /**
             * @dev Returns the current implementation address.
             */
            function _getImplementation() internal view returns (address) {
                return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
            }
            /**
             * @dev Stores a new address in the EIP1967 implementation slot.
             */
            function _setImplementation(address newImplementation) private {
                require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
                StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
            }
            /**
             * @dev Perform implementation upgrade
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeTo(address newImplementation) internal {
                _setImplementation(newImplementation);
                emit Upgraded(newImplementation);
            }
            /**
             * @dev Perform implementation upgrade with additional setup call.
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeToAndCall(
                address newImplementation,
                bytes memory data,
                bool forceCall
            ) internal {
                _upgradeTo(newImplementation);
                if (data.length > 0 || forceCall) {
                    Address.functionDelegateCall(newImplementation, data);
                }
            }
            /**
             * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
             *
             * Emits an {Upgraded} event.
             */
            function _upgradeToAndCallUUPS(
                address newImplementation,
                bytes memory data,
                bool forceCall
            ) internal {
                // Upgrades from old implementations will perform a rollback test. This test requires the new
                // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
                // this special case will break upgrade paths from old UUPS implementation to new ones.
                if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
                    _setImplementation(newImplementation);
                } else {
                    try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                        require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
                    } catch {
                        revert("ERC1967Upgrade: new implementation is not UUPS");
                    }
                    _upgradeToAndCall(newImplementation, data, forceCall);
                }
            }
            /**
             * @dev Storage slot with the admin of the contract.
             * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
             * validated in the constructor.
             */
            bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
            /**
             * @dev Emitted when the admin account has changed.
             */
            event AdminChanged(address previousAdmin, address newAdmin);
            /**
             * @dev Returns the current admin.
             */
            function _getAdmin() internal view virtual returns (address) {
                return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
            }
            /**
             * @dev Stores a new address in the EIP1967 admin slot.
             */
            function _setAdmin(address newAdmin) private {
                require(newAdmin != address(0), "ERC1967: new admin is the zero address");
                StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
            }
            /**
             * @dev Changes the admin of the proxy.
             *
             * Emits an {AdminChanged} event.
             */
            function _changeAdmin(address newAdmin) internal {
                emit AdminChanged(_getAdmin(), newAdmin);
                _setAdmin(newAdmin);
            }
            /**
             * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
             * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
             */
            bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
            /**
             * @dev Emitted when the beacon is upgraded.
             */
            event BeaconUpgraded(address indexed beacon);
            /**
             * @dev Returns the current beacon.
             */
            function _getBeacon() internal view returns (address) {
                return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
            }
            /**
             * @dev Stores a new beacon in the EIP1967 beacon slot.
             */
            function _setBeacon(address newBeacon) private {
                require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
                require(Address.isContract(IBeacon(newBeacon).implementation()), "ERC1967: beacon implementation is not a contract");
                StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
            }
            /**
             * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
             * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
             *
             * Emits a {BeaconUpgraded} event.
             */
            function _upgradeBeaconToAndCall(
                address newBeacon,
                bytes memory data,
                bool forceCall
            ) internal {
                _setBeacon(newBeacon);
                emit BeaconUpgraded(newBeacon);
                if (data.length > 0 || forceCall) {
                    Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0-rc.0) (proxy/Proxy.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
         * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
         * be specified by overriding the virtual {_implementation} function.
         *
         * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
         * different contract through the {_delegate} function.
         *
         * The success and return data of the delegated call will be returned back to the caller of the proxy.
         */
        abstract contract Proxy {
            /**
             * @dev Delegates the current call to `implementation`.
             *
             * This function does not return to its internal call site, it will return directly to the external caller.
             */
            function _delegate(address implementation) internal virtual {
                assembly {
                    // Copy msg.data. We take full control of memory in this inline assembly
                    // block because it will not return to Solidity code. We overwrite the
                    // Solidity scratch pad at memory position 0.
                    calldatacopy(0, 0, calldatasize())
                    // Call the implementation.
                    // out and outsize are 0 because we don't know the size yet.
                    let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                    // Copy the returned data.
                    returndatacopy(0, 0, returndatasize())
                    switch result
                    // delegatecall returns 0 on error.
                    case 0 {
                        revert(0, returndatasize())
                    }
                    default {
                        return(0, returndatasize())
                    }
                }
            }
            /**
             * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function
             * and {_fallback} should delegate.
             */
            function _implementation() internal view virtual returns (address);
            /**
             * @dev Delegates the current call to the address returned by `_implementation()`.
             *
             * This function does not return to its internall call site, it will return directly to the external caller.
             */
            function _fallback() internal virtual {
                _beforeFallback();
                _delegate(_implementation());
            }
            /**
             * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
             * function in the contract matches the call data.
             */
            fallback() external payable virtual {
                _fallback();
            }
            /**
             * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data
             * is empty.
             */
            receive() external payable virtual {
                _fallback();
            }
            /**
             * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`
             * call, or as part of the Solidity `fallback` or `receive` functions.
             *
             * If overriden should call `super._beforeFallback()`.
             */
            function _beforeFallback() internal virtual {}
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev This is the interface that {BeaconProxy} expects of its beacon.
         */
        interface IBeacon {
            /**
             * @dev Must return an address that can be used as a delegate call target.
             *
             * {BeaconProxy} will check that this address is a contract.
             */
            function implementation() external view returns (address);
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (proxy/transparent/TransparentUpgradeableProxy.sol)
        pragma solidity ^0.8.0;
        import "../ERC1967/ERC1967Proxy.sol";
        /**
         * @dev This contract implements a proxy that is upgradeable by an admin.
         *
         * To avoid https://medium.com/nomic-labs-blog/malicious-backdoors-in-ethereum-proxies-62629adf3357[proxy selector
         * clashing], which can potentially be used in an attack, this contract uses the
         * https://blog.openzeppelin.com/the-transparent-proxy-pattern/[transparent proxy pattern]. This pattern implies two
         * things that go hand in hand:
         *
         * 1. If any account other than the admin calls the proxy, the call will be forwarded to the implementation, even if
         * that call matches one of the admin functions exposed by the proxy itself.
         * 2. If the admin calls the proxy, it can access the admin functions, but its calls will never be forwarded to the
         * implementation. If the admin tries to call a function on the implementation it will fail with an error that says
         * "admin cannot fallback to proxy target".
         *
         * These properties mean that the admin account can only be used for admin actions like upgrading the proxy or changing
         * the admin, so it's best if it's a dedicated account that is not used for anything else. This will avoid headaches due
         * to sudden errors when trying to call a function from the proxy implementation.
         *
         * Our recommendation is for the dedicated account to be an instance of the {ProxyAdmin} contract. If set up this way,
         * you should think of the `ProxyAdmin` instance as the real administrative interface of your proxy.
         */
        contract TransparentUpgradeableProxy is ERC1967Proxy {
            /**
             * @dev Initializes an upgradeable proxy managed by `_admin`, backed by the implementation at `_logic`, and
             * optionally initialized with `_data` as explained in {ERC1967Proxy-constructor}.
             */
            constructor(
                address _logic,
                address admin_,
                bytes memory _data
            ) payable ERC1967Proxy(_logic, _data) {
                assert(_ADMIN_SLOT == bytes32(uint256(keccak256("eip1967.proxy.admin")) - 1));
                _changeAdmin(admin_);
            }
            /**
             * @dev Modifier used internally that will delegate the call to the implementation unless the sender is the admin.
             */
            modifier ifAdmin() {
                if (msg.sender == _getAdmin()) {
                    _;
                } else {
                    _fallback();
                }
            }
            /**
             * @dev Returns the current admin.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyAdmin}.
             *
             * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
             * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
             * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
             */
            function admin() external ifAdmin returns (address admin_) {
                admin_ = _getAdmin();
            }
            /**
             * @dev Returns the current implementation.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-getProxyImplementation}.
             *
             * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using the
             * https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
             * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
             */
            function implementation() external ifAdmin returns (address implementation_) {
                implementation_ = _implementation();
            }
            /**
             * @dev Changes the admin of the proxy.
             *
             * Emits an {AdminChanged} event.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-changeProxyAdmin}.
             */
            function changeAdmin(address newAdmin) external virtual ifAdmin {
                _changeAdmin(newAdmin);
            }
            /**
             * @dev Upgrade the implementation of the proxy.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-upgrade}.
             */
            function upgradeTo(address newImplementation) external ifAdmin {
                _upgradeToAndCall(newImplementation, bytes(""), false);
            }
            /**
             * @dev Upgrade the implementation of the proxy, and then call a function from the new implementation as specified
             * by `data`, which should be an encoded function call. This is useful to initialize new storage variables in the
             * proxied contract.
             *
             * NOTE: Only the admin can call this function. See {ProxyAdmin-upgradeAndCall}.
             */
            function upgradeToAndCall(address newImplementation, bytes calldata data) external payable ifAdmin {
                _upgradeToAndCall(newImplementation, data, true);
            }
            /**
             * @dev Returns the current admin.
             */
            function _admin() internal view virtual returns (address) {
                return _getAdmin();
            }
            /**
             * @dev Makes sure the admin cannot access the fallback function. See {Proxy-_beforeFallback}.
             */
            function _beforeFallback() internal virtual override {
                require(msg.sender != _getAdmin(), "TransparentUpgradeableProxy: admin cannot fallback to proxy target");
                super._beforeFallback();
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Address.sol)
        pragma solidity ^0.8.1;
        /**
         * @dev Collection of functions related to the address type
         */
        library Address {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             * ====
             *
             * [IMPORTANT]
             * ====
             * You shouldn't rely on `isContract` to protect against flash loan attacks!
             *
             * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
             * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
             * constructor.
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize/address.code.length, which returns 0
                // for contracts in construction, since the code is only stored at the end
                // of the constructor execution.
                return account.code.length > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCall(target, data, "Address: low-level call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
             * `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but also transferring `value` wei to `target`.
             *
             * Requirements:
             *
             * - the calling contract must have an ETH balance of at least `value`.
             * - the called Solidity function must be `payable`.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
            }
            /**
             * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
             * with `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(address(this).balance >= value, "Address: insufficient balance for call");
                require(isContract(target), "Address: call to non-contract");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "Address: low-level static call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                require(isContract(target), "Address: static call to non-contract");
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(isContract(target), "Address: delegate call to non-contract");
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return verifyCallResult(success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    // Look for revert reason and bubble it up if present
                    if (returndata.length > 0) {
                        // The easiest way to bubble the revert reason is using memory via assembly
                        assembly {
                            let returndata_size := mload(returndata)
                            revert(add(32, returndata), returndata_size)
                        }
                    } else {
                        revert(errorMessage);
                    }
                }
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol)
        pragma solidity ^0.8.0;
        /**
         * @dev Library for reading and writing primitive types to specific storage slots.
         *
         * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
         * This library helps with reading and writing to such slots without the need for inline assembly.
         *
         * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
         *
         * Example usage to set ERC1967 implementation slot:
         * ```
         * contract ERC1967 {
         *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
         *
         *     function _getImplementation() internal view returns (address) {
         *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
         *     }
         *
         *     function _setImplementation(address newImplementation) internal {
         *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
         *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
         *     }
         * }
         * ```
         *
         * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._
         */
        library StorageSlot {
            struct AddressSlot {
                address value;
            }
            struct BooleanSlot {
                bool value;
            }
            struct Bytes32Slot {
                bytes32 value;
            }
            struct Uint256Slot {
                uint256 value;
            }
            /**
             * @dev Returns an `AddressSlot` with member `value` located at `slot`.
             */
            function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                assembly {
                    r.slot := slot
                }
            }
            /**
             * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
             */
            function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                assembly {
                    r.slot := slot
                }
            }
            /**
             * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
             */
            function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                assembly {
                    r.slot := slot
                }
            }
            /**
             * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
             */
            function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                assembly {
                    r.slot := slot
                }
            }
        }
        

        File 6 of 6: RewardHandler
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)
        pragma solidity ^0.8.2;
        import "../../utils/AddressUpgradeable.sol";
        /**
         * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
         * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
         * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
         * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
         *
         * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
         * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
         * case an upgrade adds a module that needs to be initialized.
         *
         * For example:
         *
         * [.hljs-theme-light.nopadding]
         * ```solidity
         * contract MyToken is ERC20Upgradeable {
         *     function initialize() initializer public {
         *         __ERC20_init("MyToken", "MTK");
         *     }
         * }
         *
         * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
         *     function initializeV2() reinitializer(2) public {
         *         __ERC20Permit_init("MyToken");
         *     }
         * }
         * ```
         *
         * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
         * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
         *
         * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
         * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
         *
         * [CAUTION]
         * ====
         * Avoid leaving a contract uninitialized.
         *
         * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
         * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
         * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
         *
         * [.hljs-theme-light.nopadding]
         * ```
         * /// @custom:oz-upgrades-unsafe-allow constructor
         * constructor() {
         *     _disableInitializers();
         * }
         * ```
         * ====
         */
        abstract contract Initializable {
            /**
             * @dev Indicates that the contract has been initialized.
             * @custom:oz-retyped-from bool
             */
            uint8 private _initialized;
            /**
             * @dev Indicates that the contract is in the process of being initialized.
             */
            bool private _initializing;
            /**
             * @dev Triggered when the contract has been initialized or reinitialized.
             */
            event Initialized(uint8 version);
            /**
             * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
             * `onlyInitializing` functions can be used to initialize parent contracts.
             *
             * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
             * constructor.
             *
             * Emits an {Initialized} event.
             */
            modifier initializer() {
                bool isTopLevelCall = !_initializing;
                require(
                    (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
                    "Initializable: contract is already initialized"
                );
                _initialized = 1;
                if (isTopLevelCall) {
                    _initializing = true;
                }
                _;
                if (isTopLevelCall) {
                    _initializing = false;
                    emit Initialized(1);
                }
            }
            /**
             * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
             * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
             * used to initialize parent contracts.
             *
             * A reinitializer may be used after the original initialization step. This is essential to configure modules that
             * are added through upgrades and that require initialization.
             *
             * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
             * cannot be nested. If one is invoked in the context of another, execution will revert.
             *
             * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
             * a contract, executing them in the right order is up to the developer or operator.
             *
             * WARNING: setting the version to 255 will prevent any future reinitialization.
             *
             * Emits an {Initialized} event.
             */
            modifier reinitializer(uint8 version) {
                require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
                _initialized = version;
                _initializing = true;
                _;
                _initializing = false;
                emit Initialized(version);
            }
            /**
             * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
             * {initializer} and {reinitializer} modifiers, directly or indirectly.
             */
            modifier onlyInitializing() {
                require(_initializing, "Initializable: contract is not initializing");
                _;
            }
            /**
             * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
             * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
             * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
             * through proxies.
             *
             * Emits an {Initialized} event the first time it is successfully executed.
             */
            function _disableInitializers() internal virtual {
                require(!_initializing, "Initializable: contract is initializing");
                if (_initialized != type(uint8).max) {
                    _initialized = type(uint8).max;
                    emit Initialized(type(uint8).max);
                }
            }
            /**
             * @dev Returns the highest version that has been initialized. See {reinitializer}.
             */
            function _getInitializedVersion() internal view returns (uint8) {
                return _initialized;
            }
            /**
             * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
             */
            function _isInitializing() internal view returns (bool) {
                return _initializing;
            }
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)
        pragma solidity ^0.8.0;
        import {Initializable} from "../proxy/utils/Initializable.sol";
        /**
         * @dev Contract module that helps prevent reentrant calls to a function.
         *
         * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
         * available, which can be applied to functions to make sure there are no nested
         * (reentrant) calls to them.
         *
         * Note that because there is a single `nonReentrant` guard, functions marked as
         * `nonReentrant` may not call one another. This can be worked around by making
         * those functions `private`, and then adding `external` `nonReentrant` entry
         * points to them.
         *
         * TIP: If you would like to learn more about reentrancy and alternative ways
         * to protect against it, check out our blog post
         * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
         */
        abstract contract ReentrancyGuardUpgradeable is Initializable {
            // Booleans are more expensive than uint256 or any type that takes up a full
            // word because each write operation emits an extra SLOAD to first read the
            // slot's contents, replace the bits taken up by the boolean, and then write
            // back. This is the compiler's defense against contract upgrades and
            // pointer aliasing, and it cannot be disabled.
            // The values being non-zero value makes deployment a bit more expensive,
            // but in exchange the refund on every call to nonReentrant will be lower in
            // amount. Since refunds are capped to a percentage of the total
            // transaction's gas, it is best to keep them low in cases like this one, to
            // increase the likelihood of the full refund coming into effect.
            uint256 private constant _NOT_ENTERED = 1;
            uint256 private constant _ENTERED = 2;
            uint256 private _status;
            function __ReentrancyGuard_init() internal onlyInitializing {
                __ReentrancyGuard_init_unchained();
            }
            function __ReentrancyGuard_init_unchained() internal onlyInitializing {
                _status = _NOT_ENTERED;
            }
            /**
             * @dev Prevents a contract from calling itself, directly or indirectly.
             * Calling a `nonReentrant` function from another `nonReentrant`
             * function is not supported. It is possible to prevent this from happening
             * by making the `nonReentrant` function external, and making it call a
             * `private` function that does the actual work.
             */
            modifier nonReentrant() {
                _nonReentrantBefore();
                _;
                _nonReentrantAfter();
            }
            function _nonReentrantBefore() private {
                // On the first call to nonReentrant, _status will be _NOT_ENTERED
                require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                // Any calls to nonReentrant after this point will fail
                _status = _ENTERED;
            }
            function _nonReentrantAfter() private {
                // By storing the original value once again, a refund is triggered (see
                // https://eips.ethereum.org/EIPS/eip-2200)
                _status = _NOT_ENTERED;
            }
            /**
             * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
             * `nonReentrant` function in the call stack.
             */
            function _reentrancyGuardEntered() internal view returns (bool) {
                return _status == _ENTERED;
            }
            /**
             * @dev This empty reserved space is put in place to allow future versions to add new
             * variables without shifting down storage in the inheritance chain.
             * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
             */
            uint256[49] private __gap;
        }
        // SPDX-License-Identifier: MIT
        // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
        pragma solidity ^0.8.1;
        /**
         * @dev Collection of functions related to the address type
         */
        library AddressUpgradeable {
            /**
             * @dev Returns true if `account` is a contract.
             *
             * [IMPORTANT]
             * ====
             * It is unsafe to assume that an address for which this function returns
             * false is an externally-owned account (EOA) and not a contract.
             *
             * Among others, `isContract` will return false for the following
             * types of addresses:
             *
             *  - an externally-owned account
             *  - a contract in construction
             *  - an address where a contract will be created
             *  - an address where a contract lived, but was destroyed
             *
             * Furthermore, `isContract` will also return true if the target contract within
             * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
             * which only has an effect at the end of a transaction.
             * ====
             *
             * [IMPORTANT]
             * ====
             * You shouldn't rely on `isContract` to protect against flash loan attacks!
             *
             * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
             * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
             * constructor.
             * ====
             */
            function isContract(address account) internal view returns (bool) {
                // This method relies on extcodesize/address.code.length, which returns 0
                // for contracts in construction, since the code is only stored at the end
                // of the constructor execution.
                return account.code.length > 0;
            }
            /**
             * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
             * `recipient`, forwarding all available gas and reverting on errors.
             *
             * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
             * of certain opcodes, possibly making contracts go over the 2300 gas limit
             * imposed by `transfer`, making them unable to receive funds via
             * `transfer`. {sendValue} removes this limitation.
             *
             * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
             *
             * IMPORTANT: because control is transferred to `recipient`, care must be
             * taken to not create reentrancy vulnerabilities. Consider using
             * {ReentrancyGuard} or the
             * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
             */
            function sendValue(address payable recipient, uint256 amount) internal {
                require(address(this).balance >= amount, "Address: insufficient balance");
                (bool success, ) = recipient.call{value: amount}("");
                require(success, "Address: unable to send value, recipient may have reverted");
            }
            /**
             * @dev Performs a Solidity function call using a low level `call`. A
             * plain `call` is an unsafe replacement for a function call: use this
             * function instead.
             *
             * If `target` reverts with a revert reason, it is bubbled up by this
             * function (like regular Solidity function calls).
             *
             * Returns the raw returned data. To convert to the expected return value,
             * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
             *
             * Requirements:
             *
             * - `target` must be a contract.
             * - calling `target` with `data` must not revert.
             *
             * _Available since v3.1._
             */
            function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, "Address: low-level call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
             * `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                return functionCallWithValue(target, data, 0, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but also transferring `value` wei to `target`.
             *
             * Requirements:
             *
             * - the calling contract must have an ETH balance of at least `value`.
             * - the called Solidity function must be `payable`.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
            }
            /**
             * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
             * with `errorMessage` as a fallback revert reason when `target` reverts.
             *
             * _Available since v3.1._
             */
            function functionCallWithValue(
                address target,
                bytes memory data,
                uint256 value,
                string memory errorMessage
            ) internal returns (bytes memory) {
                require(address(this).balance >= value, "Address: insufficient balance for call");
                (bool success, bytes memory returndata) = target.call{value: value}(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                return functionStaticCall(target, data, "Address: low-level static call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a static call.
             *
             * _Available since v3.3._
             */
            function functionStaticCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                (bool success, bytes memory returndata) = target.staticcall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                return functionDelegateCall(target, data, "Address: low-level delegate call failed");
            }
            /**
             * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
             * but performing a delegate call.
             *
             * _Available since v3.4._
             */
            function functionDelegateCall(
                address target,
                bytes memory data,
                string memory errorMessage
            ) internal returns (bytes memory) {
                (bool success, bytes memory returndata) = target.delegatecall(data);
                return verifyCallResultFromTarget(target, success, returndata, errorMessage);
            }
            /**
             * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
             * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
             *
             * _Available since v4.8._
             */
            function verifyCallResultFromTarget(
                address target,
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal view returns (bytes memory) {
                if (success) {
                    if (returndata.length == 0) {
                        // only check isContract if the call was successful and the return data is empty
                        // otherwise we already know that it was a contract
                        require(isContract(target), "Address: call to non-contract");
                    }
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            /**
             * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
             * revert reason or using the provided one.
             *
             * _Available since v4.3._
             */
            function verifyCallResult(
                bool success,
                bytes memory returndata,
                string memory errorMessage
            ) internal pure returns (bytes memory) {
                if (success) {
                    return returndata;
                } else {
                    _revert(returndata, errorMessage);
                }
            }
            function _revert(bytes memory returndata, string memory errorMessage) private pure {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    /// @solidity memory-safe-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
        // SPDX-License-Identifier: BUSL-1.1
        pragma solidity 0.8.27;
        /// @dev Error for 0x0 address inputs
        error InvalidZeroInput();
        /// @dev Error for already added items to a list
        error AlreadyAdded();
        /// @dev Error for not found items in a list
        error NotFound();
        /// @dev Error for hitting max TVL
        error MaxTVLReached();
        /// @dev Error for caller not having permissions
        error NotRestakeManagerAdmin();
        /// @dev Error for call not coming from deposit queue contract
        error NotDepositQueue();
        /// @dev Error for contract being paused
        error ContractPaused();
        /// @dev Error for exceeding max basis points (100%)
        error OverMaxBasisPoints();
        /// @dev Error for invalid token decimals for collateral tokens (must be 18)
        error InvalidTokenDecimals(uint8 expected, uint8 actual);
        /// @dev Error when withdraw is already completed
        error WithdrawAlreadyCompleted();
        /// @dev Error when a different address tries to complete withdraw
        error NotOriginalWithdrawCaller(address expectedCaller);
        /// @dev Error when caller does not have OD admin role
        error NotOperatorDelegatorAdmin();
        /// @dev Error when caller does not have Oracle Admin role
        error NotOracleAdmin();
        /// @dev Error when caller is not RestakeManager contract
        error NotRestakeManager();
        /// @dev Errror when caller does not have ETH Restake Admin role
        error NotNativeEthRestakeAdmin();
        /// @dev Error when delegation address was already set - cannot be set again
        error DelegateAddressAlreadySet();
        /// @dev Error when caller does not have ERC20 Rewards Admin role
        error NotERC20RewardsAdmin();
        /// @dev Error when sending ETH fails
        error TransferFailed();
        /// @dev Error when caller does not have ETH Minter Burner Admin role
        error NotEzETHMinterBurner();
        /// @dev Error when caller does not have Token Admin role
        error NotTokenAdmin();
        /// @dev Error when price oracle is not configured
        error OracleNotFound();
        /// @dev Error when price oracle data is stale
        error OraclePriceExpired();
        /// @dev Error when array lengths do not match
        error MismatchedArrayLengths();
        /// @dev Error when caller does not have Deposit Withdraw Pauser role
        error NotDepositWithdrawPauser();
        /// @dev Error when an individual token TVL is over the max
        error MaxTokenTVLReached();
        /// @dev Error when Oracle price is invalid
        error InvalidOraclePrice();
        /// @dev Error when calling an invalid function
        error NotImplemented();
        /// @dev Error when calculating token amounts is invalid
        error InvalidTokenAmount();
        /// @dev Error when timestamp is invalid - likely in the past
        error InvalidTimestamp(uint256 timestamp);
        /// @dev Error when trade does not meet minimum output amount
        error InsufficientOutputAmount();
        /// @dev Error when the token received over the bridge is not the one expected
        error InvalidTokenReceived();
        /// @dev Error when the origin address is not whitelisted
        error InvalidOrigin();
        /// @dev Error when the sender is not expected
        error InvalidSender(address expectedSender, address actualSender);
        /// @dev error when function returns 0 amount
        error InvalidZeroOutput();
        /// @dev error when xRenzoBridge does not have enough balance to pay for fee
        error NotEnoughBalance(uint256 currentBalance, uint256 calculatedFees);
        /// @dev error when source chain is not expected
        error InvalidSourceChain(uint64 expectedCCIPChainSelector, uint64 actualCCIPChainSelector);
        /// @dev Error when an unauthorized address tries to call the bridge function on the L2
        error UnauthorizedBridgeSweeper();
        /// @dev Error when caller does not have BRIDGE_ADMIN role
        error NotBridgeAdmin();
        /// @dev Error when caller does not have PRICE_FEED_SENDER role
        error NotPriceFeedSender();
        /// @dev Error for connext price Feed unauthorised call
        error UnAuthorisedCall();
        /// @dev Error for no price feed configured on L2
        error PriceFeedNotAvailable();
        /// @dev Error for invalid bridge fee share configuration
        error InvalidBridgeFeeShare(uint256 bridgeFee);
        /// @dev Error for invalid sweep batch size
        error InvalidSweepBatchSize(uint256 batchSize);
        /// @dev Error when caller does not have Withdraw Queue admin role
        error NotWithdrawQueueAdmin();
        /// @dev Error when caller try to withdraw more than Buffer
        error NotEnoughWithdrawBuffer();
        /// @dev Error when caller try to claim withdraw before cooldown period
        error EarlyClaim();
        /// @dev Error when caller try to withdraw for unsupported asset
        error UnsupportedWithdrawAsset();
        /// @dev Error when caller try to claim invalidWithdrawIndex
        error InvalidWithdrawIndex();
        /// @dev Error when TVL was expected to be 0
        error InvalidTVL();
        /// @dev Error when incorrect BeaconChainStrategy is set for LST in completeQueuedWithdrawal
        error IncorrectStrategy();
        /// @dev Error when adding new OperatorDelegator which is not delegated
        error OperatoDelegatorNotDelegated();
        /// @dev Error when emergency tracking already tracked withdrawal
        error WithdrawalAlreadyTracked();
        /// @dev Error when emergency tracking already completed withdrawal
        error WithdrawalAlreadyCompleted();
        /// @dev Error when caller does not have Emergency Withdraw Tracking Admin role
        error NotEmergencyWithdrawTrackingAdmin();
        /// @dev Error when strategy does not have specified underlying
        error InvalidStrategy();
        /// @dev Error when strategy already set and hold non zero token balance
        error NonZeroUnderlyingStrategyExist();
        /// @dev Error when caller tried to claim queued withdrawal when not filled
        error QueuedWithdrawalNotFilled();
        /// @dev Error when caller does not have EigenLayerRewardsAdmin role
        error NotEigenLayerRewardsAdmin();
        /// @dev Error when rewardsDestination is not configured while trying to claim
        error RewardsDestinationNotConfigured();
        /// @dev Error when WETHUnwrapper is not configured while trying to claim WETH restaking rewards
        error WETHUnwrapperNotConfigured();
        /// @dev Error when currentCheckpoint is not accounted by OperatorDelegator
        error CheckpointAlreadyActive();
        /// @dev Error when specified checkpoint is already recorded
        error CheckpointAlreadyRecorded();
        /// @dev Error when caller does not have Emergency Checkpoint Tracking admin role
        error NotEmergencyCheckpointTrackingAdmin();
        /// @dev Error when last completed checkpoint on EigenPod is not recorded in OperatorDelegator
        error CheckpointNotRecorded();
        /// @dev Error when non pauser tries to change pause state
        error NotPauser();
        /// @dev Error when user tried to withdraw asset more than available in protocol collateral
        error NotEnoughCollateralValue();
        /// @dev Error when admin tries to disable asset withdraw queue which is not enabled
        error WithdrawQueueNotEnabled();
        /// @dev Error when admin tries to enable erc20 withdraw queue for IS_NATIVE address
        error IsNativeAddressNotAllowed();
        /// @dev Error when admin tried to complete queued withdrawal with receiveAsShares
        error OnlyReceiveAsTokenAllowed();
        /// @dev Error when Withdrawal is not queued
        error WithdrawalNotQueued();
        /// @dev Error when admin tries to track Withdraw of different staker
        error InvalidStakerAddress();
        /// @dev Error when caller does not have Emergency track AVS ETH slashing admin role
        error NotEmergencyTrackAVSEthSlashingAdmin();
        /// @dev Error when below the limit
        error BelowAllowedLimit();
        // SPDX-License-Identifier: BUSL-1.1
        pragma solidity 0.8.27;
        interface IRoleManager {
            /// @dev Determines if the specified address has permissions to manage RoleManager
            /// @param potentialAddress Address to check
            function isRoleManagerAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to mint or burn ezETH tokens
            /// @param potentialAddress Address to check
            function isEzETHMinterBurner(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to update config on the OperatorDelgator Contracts
            /// @param potentialAddress Address to check
            function isOperatorDelegatorAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to update config on the Oracle Contract config
            /// @param potentialAddress Address to check
            function isOracleAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to update config on the Restake Manager
            /// @param potentialAddress Address to check
            function isRestakeManagerAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to update config on the Token Contract
            /// @param potentialAddress Address to check
            function isTokenAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to trigger restaking of native ETH
            /// @param potentialAddress Address to check
            function isNativeEthRestakeAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to sweep and deposit ERC20 Rewards
            /// @param potentialAddress Address to check
            function isERC20RewardsAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to pause deposits and withdraws
            /// @param potentialAddress Address to check
            function isDepositWithdrawPauser(address potentialAddress) external view returns (bool);
            /// @dev Determines if the specified address has permission to set whitelisted origin in xRenzoBridge
            /// @param potentialAddress Address to check
            function isBridgeAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determined if the specified address has permission to send price feed of ezETH to L2
            /// @param potentialAddress Address to check
            function isPriceFeedSender(address potentialAddress) external view returns (bool);
            /// @dev Determine if the specified address haas permission to update Withdraw Queue params
            /// @param potentialAddress Address to check
            function isWithdrawQueueAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determine if the specified address has permission to track emergency pending queued withdrawals
            /// @param potentialAddress Address to check
            function isEmergencyWithdrawTrackingAdmin(
                address potentialAddress
            ) external view returns (bool);
            /// @dev Determine if the specified address has permission to process EigenLayer rewards
            /// @param potentialAddress Address to check
            function isEigenLayerRewardsAdmin(address potentialAddress) external view returns (bool);
            /// @dev Determin if the specified address has permission to track missed Checkpoints Exit Balance
            /// @param potentialAddress Address to check
            function isEmergencyCheckpointTrackingAdmin(
                address potentialAddress
            ) external view returns (bool);
            /// @dev Determin if the specified address has permission to track AVS ETH slashing amount
            /// @param potentialAddress Address to check
            function isEmergencyTrackAVSEthSlashingAdmin(
                address potentialAddress
            ) external view returns (bool);
        }
        // SPDX-License-Identifier: BUSL-1.1
        pragma solidity 0.8.27;
        import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";
        import "./RewardHandlerStorage.sol";
        import "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol";
        import "../Errors/Errors.sol";
        /**
         * @author  Renzo Protocol
         * @title   RewardHandler
         * @dev     Handles native ETH rewards deposited on the execution layer from validator nodes.  Forwards them
         * to the DepositQueue contract for restaking.
         * @notice  .
         */
        contract RewardHandler is Initializable, ReentrancyGuardUpgradeable, RewardHandlerStorageV1 {
            /// @dev Allows only a whitelisted address to trigger native ETH staking
            modifier onlyNativeEthRestakeAdmin() {
                if (!roleManager.isNativeEthRestakeAdmin(msg.sender)) revert NotNativeEthRestakeAdmin();
                _;
            }
            /// @dev Allows only a whitelisted address to configure the contract
            modifier onlyRestakeManagerAdmin() {
                if (!roleManager.isRestakeManagerAdmin(msg.sender)) revert NotRestakeManagerAdmin();
                _;
            }
            event RewardDestinationUpdated(address rewardDestination);
            /// @dev Prevents implementation contract from being initialized.
            /// @custom:oz-upgrades-unsafe-allow constructor
            constructor() {
                _disableInitializers();
            }
            /// @dev Initializes the contract with initial vars
            function initialize(IRoleManager _roleManager, address _rewardDestination) public initializer {
                __ReentrancyGuard_init();
                if (address(_roleManager) == address(0x0)) revert InvalidZeroInput();
                if (address(_rewardDestination) == address(0x0)) revert InvalidZeroInput();
                roleManager = _roleManager;
                rewardDestination = _rewardDestination;
                emit RewardDestinationUpdated(_rewardDestination);
            }
            /// @dev Forwards all native ETH rewards to the DepositQueue contract
            /// Handle ETH sent to this contract from outside the protocol that trigger contract execution - e.g. rewards
            receive() external payable nonReentrant {
                _forwardETH();
            }
            /// @dev Forwards all native ETH rewards to the DepositQueue contract
            /// Handle ETH sent to this contract from validator nodes that do not trigger contract execution - e.g. rewards
            function forwardRewards() external nonReentrant onlyNativeEthRestakeAdmin {
                _forwardETH();
            }
            function _forwardETH() internal {
                uint256 balance = address(this).balance;
                if (balance == 0) {
                    return;
                }
                (bool success, ) = rewardDestination.call{ value: balance }("");
                if (!success) revert TransferFailed();
            }
            function setRewardDestination(
                address _rewardDestination
            ) external nonReentrant onlyRestakeManagerAdmin {
                if (address(_rewardDestination) == address(0x0)) revert InvalidZeroInput();
                rewardDestination = _rewardDestination;
                emit RewardDestinationUpdated(_rewardDestination);
            }
        }
        // SPDX-License-Identifier: BUSL-1.1
        pragma solidity 0.8.27;
        import "../Permissions/IRoleManager.sol";
        abstract contract RewardHandlerStorageV1 {
            /// @dev reference to the RoleManager contract
            IRoleManager public roleManager;
            /// @dev the address of the depositQueue contract
            address public rewardDestination;
        }