ETH Price: $1,946.22 (-2.12%)

Transaction Decoder

Block:
22757648 at Jun-22-2025 04:38:11 AM +UTC
Transaction Fee:
0.000059097070890377 ETH $0.12
Gas Used:
68,171 Gas / 0.866894587 Gwei

Emitted Events:

945 GovToken.Transfer( from=[Receiver] VestManager, to=[Sender] 0x1f6f21b5ce2c10da40972976e176ef91f0c79ffb, value=681409108382450398926 )
946 VestManager.Claimed( account=[Sender] 0x1f6f21b5ce2c10da40972976e176ef91f0c79ffb, amount=681409108382450398926 )

Account State Difference:

  Address   Before After State Difference Code
0x1f6F21b5...1F0c79Ffb
0.149117642171618267 Eth
Nonce: 97
0.14905854510072789 Eth
Nonce: 98
0.000059097070890377
0x41990500...61Ed5F726
(Titan Builder)
13.498722514480009935 Eth13.498756599980009935 Eth0.0000340855
0x66666666...6360f919c

Execution Trace

VestManager.claim( _account=0x1f6F21b5Ce2C10DA40972976e176Ef91F0c79Ffb ) => ( _claimed=681409108382450398926 )
  • GovToken.transfer( to=0x1f6F21b5Ce2C10DA40972976e176Ef91F0c79Ffb, value=681409108382450398926 ) => ( True )
    File 1 of 2: VestManager
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
    import { MerkleProof } from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
    import { VestManagerBase } from "./VestManagerBase.sol";
    interface IGovToken is IERC20 {
        function INITIAL_SUPPLY() external view returns (uint256);
    }
    contract VestManager is VestManagerBase {
        uint256 constant PRECISION = 1e18;
        address immutable public prisma;
        address immutable public yprisma;
        address immutable public cvxprisma;
        uint256 public immutable INITIAL_SUPPLY;
        address public immutable BURN_ADDRESS;
        
        bool public initialized;
        uint256 public redemptionRatio;
        mapping(AllocationType => uint256) public allocationByType;
        mapping(AllocationType => uint256) public durationByType;
        mapping(AllocationType => bytes32) public merkleRootByType;
        mapping(address account => mapping(AllocationType => bool hasClaimed)) public hasClaimed; // used for airdrops only
        enum AllocationType {
            PERMA_STAKE,
            LICENSING,
            TREASURY,
            REDEMPTIONS,
            AIRDROP_TEAM,
            AIRDROP_VICTIMS,
            AIRDROP_LOCK_PENALTY
        }
        event TokenRedeemed(address indexed token, address indexed redeemer, address indexed recipient, uint256 amount);
        event MerkleRootSet(AllocationType indexed allocationType, bytes32 root);
        event AirdropClaimed(AllocationType indexed allocationType, address indexed account, address indexed recipient, uint256 amount);
        event InitializationParamsSet();
        constructor(
            address _core,
            address _token,
            address _burnAddress,
            address[3] memory _redemptionTokens // PRISMA, yPRISMA, cvxPRISMA
        ) VestManagerBase(_core, _token) {
            INITIAL_SUPPLY = IGovToken(_token).INITIAL_SUPPLY();
            require(IERC20(_token).balanceOf(address(this)) == INITIAL_SUPPLY, "VestManager not funded");
            BURN_ADDRESS = _burnAddress;
            prisma = _redemptionTokens[0];
            yprisma = _redemptionTokens[1];
            cvxprisma = _redemptionTokens[2];
        }
        /**
            @notice Set the initialization parameters for the vesting contract
            @dev All values must be set in the same order as the AllocationType enum
            @param _maxRedeemable   Maximum amount of PRISMA/yPRISMA/cvxPRISMA that can be redeemed
            @param _merkleRoots     Merkle roots for the airdrop allocations
            @param _nonUserTargets  Addresses to receive the non-user allocations
            @param _vestDurations  Durations of the vesting periods for each type
            @param _allocPercentages Percentages of the initial supply allocated to each type,  
                the first two values being perma-stakers, followed by all other allocation types in order of 
                AllocationType enum.
        */
        function setInitializationParams(
            uint256 _maxRedeemable,
            bytes32[3] memory _merkleRoots,
            address[4] memory _nonUserTargets,
            uint256[8] memory _vestDurations,
            uint256[8] memory _allocPercentages
        ) external onlyOwner {
            require(!initialized, "params already set");
            initialized = true;
            uint256 totalPctAllocated;
            uint256 airdropIndex;
            require(_vestDurations[0] == _vestDurations[1], "perma-staker durations must match");
            for (uint256 i = 0; i < _allocPercentages.length; i++) {
                AllocationType allocType = i == 0 ? AllocationType(i) : AllocationType(i-1); // First two are same type
                require(_vestDurations[i] > 0 && _vestDurations[i] <= type(uint32).max, "invalid duration");
                durationByType[allocType] = uint32(_vestDurations[i]);
                totalPctAllocated += _allocPercentages[i];
                uint256 allocation = _allocPercentages[i] * INITIAL_SUPPLY / PRECISION;
                allocationByType[allocType] += allocation;
                
                if (i < _nonUserTargets.length) { 
                    _createVest(
                        _nonUserTargets[i], 
                        uint32(_vestDurations[i]), 
                        uint112(allocation)
                    );
                    continue;
                }
                if (
                    allocType == AllocationType.AIRDROP_TEAM ||
                    allocType == AllocationType.AIRDROP_VICTIMS ||
                    allocType == AllocationType.AIRDROP_LOCK_PENALTY
                ) {
                    // Set merkle roots for airdrop allocations
                    merkleRootByType[allocType] = _merkleRoots[airdropIndex];
                    emit MerkleRootSet(allocType, _merkleRoots[airdropIndex++]);
                }
            }
            // Set the redemption ratio to be used for all PRISMA/yPRISMA/cvxPRISMA redemptions
            uint256 _redemptionRatio = (
                allocationByType[AllocationType.REDEMPTIONS] * 1e18 / _maxRedeemable
            );
            redemptionRatio = _redemptionRatio;
            require(_redemptionRatio != 0, "ratio is 0");
            require(totalPctAllocated == PRECISION, "Total not 100%");
            emit InitializationParamsSet();
        }
        /**
            @notice Set the merkle root for the lock penalty airdrop
            @dev This root must be set later after lock penalty data is finalized
            @param _root Merkle root for the lock penalty airdrop
            @param _allocation Allocation for the lock penalty airdrop
        */
        function setLockPenaltyMerkleRoot(bytes32 _root, uint256 _allocation) external onlyOwner {
            require(initialized, "init params not set");
            require(merkleRootByType[AllocationType.AIRDROP_LOCK_PENALTY] == bytes32(0), "root already set");
            merkleRootByType[AllocationType.AIRDROP_LOCK_PENALTY] = _root;
            emit MerkleRootSet(AllocationType.AIRDROP_LOCK_PENALTY, _root);
            allocationByType[AllocationType.AIRDROP_LOCK_PENALTY] = _allocation;
        }
        function merkleClaim(
            address _account,
            address _recipient,
            uint256 _amount,
            AllocationType _type,
            bytes32[] calldata _proof,
            uint256 _index
        ) external callerOrDelegated(_account) {
            require(
                _type == AllocationType.AIRDROP_TEAM || 
                _type == AllocationType.AIRDROP_LOCK_PENALTY || 
                _type == AllocationType.AIRDROP_VICTIMS, 
                "invalid type"
            );
            bytes32 _root = merkleRootByType[_type];
            require(_root != bytes32(0), "root not set");
            require(!hasClaimed[_account][_type], "already claimed");
            bytes32 node = keccak256(abi.encodePacked(_account, _index, _amount));
            require(MerkleProof.verifyCalldata(
                _proof, 
                _root, 
                node
            ), "invalid proof");
            _createVest(
                _recipient,
                uint32(durationByType[_type]),
                uint112(_amount)
            );
            hasClaimed[_account][_type] = true;
            emit AirdropClaimed(_type, _account, _recipient, _amount);
        }
        /**
            @notice Redeem PRISMA tokens for RSUP tokens
            @param _token    Token to redeem (PRISMA, yPRISMA or cvxPRISMA)
            @param _recipient Address to receive the RSUP tokens
            @param _amount   Amount of tokens to redeem
            @dev This function allows users to convert their PRISMA tokens to RSUP tokens
                 at the redemption ratio. The input tokens are burned in the process.
        */
        function redeem(address _token, address _recipient, uint256 _amount) external {
            require(
                _token == address(prisma) || 
                _token == address(yprisma) || 
                _token == address(cvxprisma), 
                "invalid token"
            );
            require(_amount > 0, "amount too low");
            uint256 _ratio = redemptionRatio;
            require(_ratio != 0, "ratio not set");
            IERC20(_token).transferFrom(msg.sender, BURN_ADDRESS, _amount);
            _createVest(
                _recipient,
                uint32(durationByType[AllocationType.REDEMPTIONS]),
                uint112(_amount * _ratio / 1e18)
            );
            emit TokenRedeemed(_token, msg.sender, _recipient, _amount);
        }
    }// SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Interface of the ERC-20 standard as defined in the ERC.
     */
    interface IERC20 {
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
        /**
         * @dev Returns the value of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the value of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves a `value` amount of tokens from the caller's account to `to`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address to, uint256 value) 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 a `value` amount of tokens 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 value) external returns (bool);
        /**
         * @dev Moves a `value` amount of tokens from `from` to `to` using the
         * allowance mechanism. `value` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address from, address to, uint256 value) external returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/MerkleProof.sol)
    // This file was procedurally generated from scripts/generate/templates/MerkleProof.js.
    pragma solidity ^0.8.20;
    import {Hashes} from "./Hashes.sol";
    /**
     * @dev These functions deal with verification of Merkle Tree proofs.
     *
     * The tree and the proofs can be generated using our
     * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
     * You will find a quickstart guide in the readme.
     *
     * WARNING: You should avoid using leaf values that are 64 bytes long prior to
     * hashing, or use a hash function other than keccak256 for hashing leaves.
     * This is because the concatenation of a sorted pair of internal nodes in
     * the Merkle tree could be reinterpreted as a leaf value.
     * OpenZeppelin's JavaScript library generates Merkle trees that are safe
     * against this attack out of the box.
     *
     * IMPORTANT: Consider memory side-effects when using custom hashing functions
     * that access memory in an unsafe way.
     *
     * NOTE: This library supports proof verification for merkle trees built using
     * custom _commutative_ hashing functions (i.e. `H(a, b) == H(b, a)`). Proving
     * leaf inclusion in trees built using non-commutative hashing functions requires
     * additional logic that is not supported by this library.
     */
    library MerkleProof {
        /**
         *@dev The multiproof provided is not valid.
         */
        error MerkleProofInvalidMultiproof();
        /**
         * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
         * defined by `root`. For this, a `proof` must be provided, containing
         * sibling hashes on the branch from the leaf to the root of the tree. Each
         * pair of leaves and each pair of pre-images are assumed to be sorted.
         *
         * This version handles proofs in memory with the default hashing function.
         */
        function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
            return processProof(proof, leaf) == root;
        }
        /**
         * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
         * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
         * hash matches the root of the tree. When processing the proof, the pairs
         * of leaves & pre-images are assumed to be sorted.
         *
         * This version handles proofs in memory with the default hashing function.
         */
        function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
            bytes32 computedHash = leaf;
            for (uint256 i = 0; i < proof.length; i++) {
                computedHash = Hashes.commutativeKeccak256(computedHash, proof[i]);
            }
            return computedHash;
        }
        /**
         * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
         * defined by `root`. For this, a `proof` must be provided, containing
         * sibling hashes on the branch from the leaf to the root of the tree. Each
         * pair of leaves and each pair of pre-images are assumed to be sorted.
         *
         * This version handles proofs in memory with a custom hashing function.
         */
        function verify(
            bytes32[] memory proof,
            bytes32 root,
            bytes32 leaf,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bool) {
            return processProof(proof, leaf, hasher) == root;
        }
        /**
         * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
         * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
         * hash matches the root of the tree. When processing the proof, the pairs
         * of leaves & pre-images are assumed to be sorted.
         *
         * This version handles proofs in memory with a custom hashing function.
         */
        function processProof(
            bytes32[] memory proof,
            bytes32 leaf,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bytes32) {
            bytes32 computedHash = leaf;
            for (uint256 i = 0; i < proof.length; i++) {
                computedHash = hasher(computedHash, proof[i]);
            }
            return computedHash;
        }
        /**
         * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
         * defined by `root`. For this, a `proof` must be provided, containing
         * sibling hashes on the branch from the leaf to the root of the tree. Each
         * pair of leaves and each pair of pre-images are assumed to be sorted.
         *
         * This version handles proofs in calldata with the default hashing function.
         */
        function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
            return processProofCalldata(proof, leaf) == root;
        }
        /**
         * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
         * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
         * hash matches the root of the tree. When processing the proof, the pairs
         * of leaves & pre-images are assumed to be sorted.
         *
         * This version handles proofs in calldata with the default hashing function.
         */
        function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
            bytes32 computedHash = leaf;
            for (uint256 i = 0; i < proof.length; i++) {
                computedHash = Hashes.commutativeKeccak256(computedHash, proof[i]);
            }
            return computedHash;
        }
        /**
         * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
         * defined by `root`. For this, a `proof` must be provided, containing
         * sibling hashes on the branch from the leaf to the root of the tree. Each
         * pair of leaves and each pair of pre-images are assumed to be sorted.
         *
         * This version handles proofs in calldata with a custom hashing function.
         */
        function verifyCalldata(
            bytes32[] calldata proof,
            bytes32 root,
            bytes32 leaf,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bool) {
            return processProofCalldata(proof, leaf, hasher) == root;
        }
        /**
         * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
         * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
         * hash matches the root of the tree. When processing the proof, the pairs
         * of leaves & pre-images are assumed to be sorted.
         *
         * This version handles proofs in calldata with a custom hashing function.
         */
        function processProofCalldata(
            bytes32[] calldata proof,
            bytes32 leaf,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bytes32) {
            bytes32 computedHash = leaf;
            for (uint256 i = 0; i < proof.length; i++) {
                computedHash = hasher(computedHash, proof[i]);
            }
            return computedHash;
        }
        /**
         * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
         * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
         *
         * This version handles multiproofs in memory with the default hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
         *
         * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
         * The `leaves` must be validated independently. See {processMultiProof}.
         */
        function multiProofVerify(
            bytes32[] memory proof,
            bool[] memory proofFlags,
            bytes32 root,
            bytes32[] memory leaves
        ) internal pure returns (bool) {
            return processMultiProof(proof, proofFlags, leaves) == root;
        }
        /**
         * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
         * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
         * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
         * respectively.
         *
         * This version handles multiproofs in memory with the default hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
         * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
         * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
         *
         * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
         * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
         * validating the leaves elsewhere.
         */
        function processMultiProof(
            bytes32[] memory proof,
            bool[] memory proofFlags,
            bytes32[] memory leaves
        ) internal pure returns (bytes32 merkleRoot) {
            // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
            // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
            // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
            // the Merkle tree.
            uint256 leavesLen = leaves.length;
            uint256 proofFlagsLen = proofFlags.length;
            // Check proof validity.
            if (leavesLen + proof.length != proofFlagsLen + 1) {
                revert MerkleProofInvalidMultiproof();
            }
            // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
            // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
            bytes32[] memory hashes = new bytes32[](proofFlagsLen);
            uint256 leafPos = 0;
            uint256 hashPos = 0;
            uint256 proofPos = 0;
            // At each step, we compute the next hash using two values:
            // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
            //   get the next hash.
            // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
            //   `proof` array.
            for (uint256 i = 0; i < proofFlagsLen; i++) {
                bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
                bytes32 b = proofFlags[i]
                    ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                    : proof[proofPos++];
                hashes[i] = Hashes.commutativeKeccak256(a, b);
            }
            if (proofFlagsLen > 0) {
                if (proofPos != proof.length) {
                    revert MerkleProofInvalidMultiproof();
                }
                unchecked {
                    return hashes[proofFlagsLen - 1];
                }
            } else if (leavesLen > 0) {
                return leaves[0];
            } else {
                return proof[0];
            }
        }
        /**
         * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
         * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
         *
         * This version handles multiproofs in memory with a custom hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
         *
         * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
         * The `leaves` must be validated independently. See {processMultiProof}.
         */
        function multiProofVerify(
            bytes32[] memory proof,
            bool[] memory proofFlags,
            bytes32 root,
            bytes32[] memory leaves,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bool) {
            return processMultiProof(proof, proofFlags, leaves, hasher) == root;
        }
        /**
         * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
         * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
         * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
         * respectively.
         *
         * This version handles multiproofs in memory with a custom hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
         * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
         * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
         *
         * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
         * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
         * validating the leaves elsewhere.
         */
        function processMultiProof(
            bytes32[] memory proof,
            bool[] memory proofFlags,
            bytes32[] memory leaves,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bytes32 merkleRoot) {
            // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
            // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
            // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
            // the Merkle tree.
            uint256 leavesLen = leaves.length;
            uint256 proofFlagsLen = proofFlags.length;
            // Check proof validity.
            if (leavesLen + proof.length != proofFlagsLen + 1) {
                revert MerkleProofInvalidMultiproof();
            }
            // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
            // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
            bytes32[] memory hashes = new bytes32[](proofFlagsLen);
            uint256 leafPos = 0;
            uint256 hashPos = 0;
            uint256 proofPos = 0;
            // At each step, we compute the next hash using two values:
            // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
            //   get the next hash.
            // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
            //   `proof` array.
            for (uint256 i = 0; i < proofFlagsLen; i++) {
                bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
                bytes32 b = proofFlags[i]
                    ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                    : proof[proofPos++];
                hashes[i] = hasher(a, b);
            }
            if (proofFlagsLen > 0) {
                if (proofPos != proof.length) {
                    revert MerkleProofInvalidMultiproof();
                }
                unchecked {
                    return hashes[proofFlagsLen - 1];
                }
            } else if (leavesLen > 0) {
                return leaves[0];
            } else {
                return proof[0];
            }
        }
        /**
         * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
         * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
         *
         * This version handles multiproofs in calldata with the default hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
         *
         * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
         * The `leaves` must be validated independently. See {processMultiProofCalldata}.
         */
        function multiProofVerifyCalldata(
            bytes32[] calldata proof,
            bool[] calldata proofFlags,
            bytes32 root,
            bytes32[] memory leaves
        ) internal pure returns (bool) {
            return processMultiProofCalldata(proof, proofFlags, leaves) == root;
        }
        /**
         * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
         * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
         * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
         * respectively.
         *
         * This version handles multiproofs in calldata with the default hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
         * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
         * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
         *
         * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
         * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
         * validating the leaves elsewhere.
         */
        function processMultiProofCalldata(
            bytes32[] calldata proof,
            bool[] calldata proofFlags,
            bytes32[] memory leaves
        ) internal pure returns (bytes32 merkleRoot) {
            // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
            // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
            // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
            // the Merkle tree.
            uint256 leavesLen = leaves.length;
            uint256 proofFlagsLen = proofFlags.length;
            // Check proof validity.
            if (leavesLen + proof.length != proofFlagsLen + 1) {
                revert MerkleProofInvalidMultiproof();
            }
            // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
            // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
            bytes32[] memory hashes = new bytes32[](proofFlagsLen);
            uint256 leafPos = 0;
            uint256 hashPos = 0;
            uint256 proofPos = 0;
            // At each step, we compute the next hash using two values:
            // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
            //   get the next hash.
            // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
            //   `proof` array.
            for (uint256 i = 0; i < proofFlagsLen; i++) {
                bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
                bytes32 b = proofFlags[i]
                    ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                    : proof[proofPos++];
                hashes[i] = Hashes.commutativeKeccak256(a, b);
            }
            if (proofFlagsLen > 0) {
                if (proofPos != proof.length) {
                    revert MerkleProofInvalidMultiproof();
                }
                unchecked {
                    return hashes[proofFlagsLen - 1];
                }
            } else if (leavesLen > 0) {
                return leaves[0];
            } else {
                return proof[0];
            }
        }
        /**
         * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
         * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
         *
         * This version handles multiproofs in calldata with a custom hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
         *
         * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
         * The `leaves` must be validated independently. See {processMultiProofCalldata}.
         */
        function multiProofVerifyCalldata(
            bytes32[] calldata proof,
            bool[] calldata proofFlags,
            bytes32 root,
            bytes32[] memory leaves,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bool) {
            return processMultiProofCalldata(proof, proofFlags, leaves, hasher) == root;
        }
        /**
         * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
         * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
         * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
         * respectively.
         *
         * This version handles multiproofs in calldata with a custom hashing function.
         *
         * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
         * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
         * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
         *
         * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
         * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
         * validating the leaves elsewhere.
         */
        function processMultiProofCalldata(
            bytes32[] calldata proof,
            bool[] calldata proofFlags,
            bytes32[] memory leaves,
            function(bytes32, bytes32) view returns (bytes32) hasher
        ) internal view returns (bytes32 merkleRoot) {
            // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
            // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
            // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
            // the Merkle tree.
            uint256 leavesLen = leaves.length;
            uint256 proofFlagsLen = proofFlags.length;
            // Check proof validity.
            if (leavesLen + proof.length != proofFlagsLen + 1) {
                revert MerkleProofInvalidMultiproof();
            }
            // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
            // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
            bytes32[] memory hashes = new bytes32[](proofFlagsLen);
            uint256 leafPos = 0;
            uint256 hashPos = 0;
            uint256 proofPos = 0;
            // At each step, we compute the next hash using two values:
            // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
            //   get the next hash.
            // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
            //   `proof` array.
            for (uint256 i = 0; i < proofFlagsLen; i++) {
                bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
                bytes32 b = proofFlags[i]
                    ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
                    : proof[proofPos++];
                hashes[i] = hasher(a, b);
            }
            if (proofFlagsLen > 0) {
                if (proofPos != proof.length) {
                    revert MerkleProofInvalidMultiproof();
                }
                unchecked {
                    return hashes[proofFlagsLen - 1];
                }
            } else if (leavesLen > 0) {
                return leaves[0];
            } else {
                return proof[0];
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
    import { DelegatedOps } from '../../dependencies/DelegatedOps.sol';
    import { CoreOwnable } from '../../dependencies/CoreOwnable.sol';
    import { IVestClaimCallback } from 'src/interfaces/IVestClaimCallback.sol';
    contract VestManagerBase is CoreOwnable, DelegatedOps {
        uint256 public immutable VEST_GLOBAL_START_TIME;
        IERC20 public immutable token;
        mapping(address => Vest[]) public userVests;
        mapping(address => ClaimSettings) public claimSettings;
        struct Vest {
            uint32 duration; // max of ~56k days
            uint112 amount;
            uint112 claimed;
        }
        struct ClaimSettings {
            bool allowPermissionlessClaims;
            address recipient;
        }
        event VestCreated(address indexed account, uint256 indexed duration, uint256 amount);
        event Claimed(address indexed account, uint256 amount);
        event ClaimSettingsSet(address indexed account, bool indexed allowPermissionlessClaims, address indexed recipient);
        constructor(address _core, address _token) CoreOwnable(_core) {
            token = IERC20(_token);
            VEST_GLOBAL_START_TIME = block.timestamp;
        }
        /// @notice Creates or adds to a vesting instance for an account
        /// @param _account The address to create the vest for
        /// @param _duration The duration of the vesting period in seconds
        /// @param _amount The amount of tokens to vest
        /// @return The total number of vesting instances for the account
        function _createVest(
            address _account,
            uint32 _duration,
            uint112 _amount
        ) internal returns (uint256) {
            require(_account != address(0), "zero address");
            require(_amount > 0, "Amount must be greater than zero");
            uint256 length = numAccountVests(_account);
            // If a vest with matching duration already exists, simply add to its amount
            for (uint256 i = 0; i < length; i++) {
                if (userVests[_account][i].duration == _duration) {
                    userVests[_account][i].amount += _amount;
                    return length;
                }
            }
            // If the duration does not exist, create a new vest
            userVests[_account].push(Vest(
                _duration,
                _amount,
                0
            ));
            emit VestCreated(_account, _duration, _amount);
            return length + 1;
        }
        function numAccountVests(address _account) public view returns (uint256) {
            return userVests[_account].length;
        }
        /**
         * @notice Claims all available vested tokens for an account
         * @param _account Address to claim tokens for
         * @return _claimed Total amount of tokens claimed
         * @dev Any caller can claim on behalf of an account, unless explicitly blocked via account's claimSettings
         */
        function claim(address _account) external returns (uint256 _claimed) {
            address recipient = _enforceClaimSettings(_account);
            _claimed = _claim(_account);
            if (_claimed > 0) {
                token.transfer(recipient, _claimed);
                emit Claimed(_account, _claimed);
            }
        }
        /**
         * @notice Claims all available vested tokens for an account, and calls a callback to handle the tokens
         * @dev Important: the claimed tokens are transferred to the callback contract for handling, not the recipient
         * @dev Restricted to the account or a delegated caller
         * @param _account Address to claim tokens for
         * @param _callback Address of the callback contract to use
         * @return _claimed Total amount of tokens claimed
         */
        function claimWithCallback(
            address _account, 
            address _callback
        ) external callerOrDelegated(_account) returns (uint256 _claimed) {
            address recipient = _enforceClaimSettings(_account);
            _claimed = _claim(_account);
            if (_claimed > 0) {
                token.transfer(_callback, _claimed);
                require(IVestClaimCallback(_callback).onClaim(_account, recipient, _claimed), "callback failed");
                emit Claimed(_account, _claimed);
            }
        }
        function _claim(address _account) internal returns (uint256 _claimed) {
            Vest[] storage vests = userVests[_account];
            uint256 length = vests.length;
            require(length > 0, "No vests to claim");
            for (uint256 i = 0; i < length; i++) {
                uint112 claimable = _claimableAmount(vests[i]);
                if (claimable > 0) {
                    vests[i].claimed += claimable;
                    _claimed += claimable;
                }
            }
        }
        function _enforceClaimSettings(address _account) internal view returns (address) {
            ClaimSettings memory settings = claimSettings[_account];
            if (!settings.allowPermissionlessClaims) {
                require(msg.sender == _account, "!authorized");
            }
            return settings.recipient != address(0) ? settings.recipient : _account;
        }
        /**
         * @notice Get aggregated vesting data for an account. Includes all vests for the account.
         * @param _account Address of the account to query
         * @return _totalAmount Total amount of tokens in all vests for the account
         * @return _totalClaimable Amount of tokens that can be claimed by the account
         * @return _totalClaimed Amount of tokens already claimed by the account
         * @dev Iterates through all vests for the account to calculate totals
         */
        function getAggregateVestData(address _account) external view returns (
            uint256 _totalAmount,
            uint256 _totalClaimable,
            uint256 _totalClaimed
        ) {
            uint256 length = numAccountVests(_account);
            for (uint256 i = 0; i < length; i++) {
                (uint256 _total, uint256 _claimable, uint256 _claimed,) = _vestData(userVests[_account][i]);
                _totalAmount += _total;
                _totalClaimable += _claimable;
                _totalClaimed += _claimed;
            }
        }
        /**
         * @notice Get single vest data for an account
         * @param _account Address of the account to query
         * @param index Index of the vest to query
         * @return _total Total amount of tokens in the vest
         * @return _claimable Amount of tokens that can be claimed for the vest
         * @return _claimed Amount of tokens already claimed for the vest
         * @return _timeRemaining Time remaining until vesting is complete
         */
        function getSingleVestData(address _account, uint256 index) external view returns (
            uint256 _total,
            uint256 _claimable,
            uint256 _claimed,
            uint256 _timeRemaining
        ) {
            return _vestData(userVests[_account][index]);
        }
        function _vestData(Vest memory vest) internal view returns (
            uint256 _total,
            uint256 _claimable,
            uint256 _claimed,
            uint256 _timeRemaining
        ){
            uint256 vested = _vestedAmount(vest);
            _total = vest.amount;
            _claimable = vested - vest.claimed;
            _claimed = vest.claimed;
            uint256 elapsed = block.timestamp - VEST_GLOBAL_START_TIME;
            _timeRemaining = elapsed > vest.duration ? 0 : vest.duration - elapsed;
        }
        function _claimableAmount(Vest storage vest) internal view returns (uint112) {
            return uint112(_vestedAmount(vest) - vest.claimed);
        }
        function _vestedAmount(Vest memory vest) internal view returns (uint256) {
            if (block.timestamp < VEST_GLOBAL_START_TIME) {
                return 0;
            } else if (block.timestamp >= VEST_GLOBAL_START_TIME + vest.duration) {
                return vest.amount;
            } else {
                return (vest.amount * (block.timestamp - VEST_GLOBAL_START_TIME)) / vest.duration;
            }
        }
        function setClaimSettings( 
            bool _allowPermissionlessClaims, 
            address _recipient
        ) external {
            claimSettings[msg.sender] = ClaimSettings(_allowPermissionlessClaims, _recipient);
            emit ClaimSettingsSet(msg.sender, _allowPermissionlessClaims, _recipient);
        }
    }// SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/Hashes.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Library of standard hash functions.
     *
     * _Available since v5.1._
     */
    library Hashes {
        /**
         * @dev Commutative Keccak256 hash of a sorted pair of bytes32. Frequently used when working with merkle proofs.
         *
         * NOTE: Equivalent to the `standardNodeHash` in our https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
         */
        function commutativeKeccak256(bytes32 a, bytes32 b) internal pure returns (bytes32) {
            return a < b ? _efficientKeccak256(a, b) : _efficientKeccak256(b, a);
        }
        /**
         * @dev Implementation of keccak256(abi.encode(a, b)) that doesn't allocate or expand memory.
         */
        function _efficientKeccak256(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
            assembly ("memory-safe") {
                mstore(0x00, a)
                mstore(0x20, b)
                value := keccak256(0x00, 0x40)
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    /**
        @title Delegated Operations
        @author Prisma Finance (with edits by Resupply Finance)
        @notice Allows delegation to specific contract functionality. Useful for creating
                wrapper contracts to bundle multiple interactions into a single call.
     */
    contract DelegatedOps {
        event DelegateApprovalSet(address indexed account, address indexed delegate, bool isApproved);
        mapping(address owner => mapping(address caller => bool isApproved)) public isApprovedDelegate;
        modifier callerOrDelegated(address _account) {
            require(msg.sender == _account || isApprovedDelegate[_account][msg.sender], "!CallerOrDelegated");
            _;
        }
        function setDelegateApproval(address _delegate, bool _isApproved) external {
            isApprovedDelegate[msg.sender][_delegate] = _isApproved;
            emit DelegateApprovalSet(msg.sender, _delegate, _isApproved);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    import {ICore} from "../interfaces/ICore.sol";
    /**
        @title Core Ownable
        @author Prisma Finance (with edits by Resupply Finance)
        @notice Contracts inheriting `CoreOwnable` have the same owner as `Core`.
                The ownership cannot be independently modified or renounced.
     */
    contract CoreOwnable {
        ICore public immutable core;
        constructor(address _core) {
            core = ICore(_core);
        }
        modifier onlyOwner() {
            require(msg.sender == address(core), "!core");
            _;
        }
        function owner() public view returns (address) {
            return address(core);
        }
    }// SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    import { IGovStaker } from "./IGovStaker.sol";
    import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
    interface IVestClaimCallback {
        event RecoveredERC20(address indexed token, address indexed recipient, uint256 amount);
        function govStaker() external view returns (IGovStaker);
        function vestManager() external view returns (address);
        function token() external view returns (IERC20);
        
        function onClaim(
            address account,
            address recipient,
            uint256 amount
        ) external returns (bool success);
        
        function recoverERC20(address token, address recipient, uint256 amount) external;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    import { IAuthHook } from './IAuthHook.sol';
    interface ICore {
        struct OperatorAuth {
            bool authorized;
            IAuthHook hook;
        }
        event VoterSet(address indexed newVoter);
        event OperatorExecuted(address indexed caller, address indexed target, bytes data);
        event OperatorSet(address indexed caller, address indexed target, bool authorized, bytes4 selector, IAuthHook authHook);
        function execute(address target, bytes calldata data) external returns (bytes memory);
        function epochLength() external view returns (uint256);
        function startTime() external view returns (uint256);
        function voter() external view returns (address);
        function ownershipTransferDeadline() external view returns (uint256);
        function pendingOwner() external view returns (address);
        function setOperatorPermissions(
            address caller,
            address target,
            bytes4 selector,
            bool authorized,
            IAuthHook authHook
        ) external;
        function setVoter(address newVoter) external;
        function operatorPermissions(address caller, address target, bytes4 selector) external view returns (bool authorized, IAuthHook hook);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    interface IGovStaker {
        /* ========== EVENTS ========== */
        event RewardAdded(address indexed rewardToken, uint256 amount);
        event RewardTokenAdded(address indexed rewardsToken, address indexed rewardsDistributor, uint256 rewardsDuration);
        event Recovered(address indexed token, uint256 amount);
        event RewardsDurationUpdated(address indexed rewardsToken, uint256 duration);
        event RewardPaid(address indexed user, address indexed rewardToken, uint256 reward);
        event Staked(address indexed account, uint indexed epoch, uint amount);
        event Unstaked(address indexed account, uint amount);
        event Cooldown(address indexed account, uint amount, uint end);
        event CooldownEpochsUpdated(uint24 newDuration);
        /* ========== STRUCTS ========== */
        struct Reward {
            address rewardsDistributor;
            uint256 rewardsDuration;
            uint256 periodFinish;
            uint256 rewardRate;
            uint256 lastUpdateTime;
            uint256 rewardPerTokenStored;
        }
        struct AccountData {
            uint120 realizedStake; // Amount of stake that has fully realized weight.
            uint120 pendingStake; // Amount of stake that has not yet fully realized weight.
            uint16 lastUpdateEpoch;
        }
        struct UserCooldown {
            uint104 end;
            uint152 amount;
        }
        enum ApprovalStatus {
            None, // 0. Default value, indicating no approval
            StakeOnly, // 1. Approved for stake only
            UnstakeOnly, // 2. Approved for unstake only
            StakeAndUnstake // 3. Approved for both stake and unstake
        }
        /* ========== STATE VARIABLES ========== */
        function rewardTokens(uint256 index) external view returns (address);
        function rewardData(address token) external view returns (Reward memory);
        function rewards(address account, address token) external view returns (uint256);
        function userRewardPerTokenPaid(address account, address token) external view returns (uint256);
        function CORE() external view returns (address);
        function PRECISION() external view returns (uint256);
        function ESCROW() external view returns (address);
        function MAX_COOLDOWN_DURATION() external view returns (uint24);
        function totalPending() external view returns (uint120);
        function totalLastUpdateEpoch() external view returns (uint16);
        function cooldownEpochs() external view returns (uint256);
        function decimals() external view returns (uint8);
        function approvedCaller(address account, address caller) external view returns (ApprovalStatus);
        /* ========== EXTERNAL FUNCTIONS ========== */
        function accountData(address account) external view returns (AccountData memory);
        function stakeToken() external view returns (address);
        function balanceOf(address account) external view returns (uint256);
        function totalSupply() external view returns (uint256);
        function getReward() external;
        function getOneReward(address rewardsToken) external;
        function addReward(address rewardsToken, address rewardsDistributor, uint256 rewardsDuration) external;
        function notifyRewardAmount(address rewardsToken, uint256 rewardAmount) external;
        function setRewardsDistributor(address rewardsToken, address rewardsDistributor) external;
        function setRewardsDuration(address rewardsToken, uint256 rewardsDuration) external;
        function recoverERC20(address tokenAddress, uint256 tokenAmount) external;
        function stake(address account, uint amount) external returns (uint);
        function stakeFor(address account, uint amount) external returns (uint);
        function cooldown(address account, uint amount) external returns (uint);
        function cooldowns(address account) external view returns (UserCooldown memory);
        function cooldownFor(address account, uint amount) external returns (uint);
        function exit(address account) external returns (uint);
        function exitFor(address account) external returns (uint);
        function unstake(address account, address receiver) external returns (uint);
        function unstakeFor(address account, address receiver) external returns (uint);
        function checkpointAccount(address account) external returns (AccountData memory, uint weight);
        function checkpointAccountWithLimit(address account, uint epoch) external returns (AccountData memory, uint weight);
        function checkpointTotal() external returns (uint);
        function setApprovedCaller(address caller, ApprovalStatus status) external;
        function setCooldownEpochs(uint24 epochs) external;
        function getAccountWeight(address account) external view returns (uint);
        function getAccountWeightAt(address account, uint epoch) external view returns (uint);
        function getTotalWeight() external view returns (uint);
        function getTotalWeightAt(uint epoch) external view returns (uint);
        function getUnstakableAmount(address account) external view returns (uint);
        function isCooldownEnabled() external view returns (bool);
        function rewardTokensLength() external view returns (uint256);
        function earned(address account, address rewardsToken) external view returns (uint256 pending);
        function earnedMulti(address account) external view returns (uint256[] memory pending);
        function rewardPerToken(address rewardsToken) external view returns (uint256 rewardAmount);
        function lastTimeRewardApplicable(address rewardsToken) external view returns (uint256);
        function getRewardForDuration(address rewardsToken) external view returns (uint256);
        function owner() external view returns (address);
        function guardian() external view returns (address);
        function getEpoch() external view returns (uint);
        function epochLength() external view returns (uint);
        function startTime() external view returns (uint);
        function irreversiblyCommitAccountAsPermanentStaker(address account) external;
        function onPermaStakeMigrate(address account) external;
        function migrateStake() external returns (uint amount);
        function setDelegateApproval(address delegate, bool approved) external;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    interface IAuthHook {
        function preHook(address operator, address target, bytes calldata data) external returns (bool);
        function postHook(bytes memory result, address operator, address target, bytes calldata data) external returns (bool);
    }
    

    File 2 of 2: GovToken
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.28;
    import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";
    import { OFT } from "@layerzerolabs/oft-evm/contracts/OFT.sol";
    contract GovToken is OFT {
        uint256 public immutable INITIAL_SUPPLY;
        uint256 public globalSupply;
        bool public minterFinalized;
        address public minter;
        event FinalizeMinter();
        event MinterSet(address indexed minter);
        modifier onlyMinter() {
            require(msg.sender == minter, "!minter");
            _;
        }
        constructor(
            address _core,
            address _vesting,
            uint256 _initialSupply,
            address _endpoint,
            string memory _name,
            string memory _symbol
        ) OFT(_name, _symbol, _endpoint, _core)
          Ownable(_core) {
            INITIAL_SUPPLY = _initialSupply;
            _mint(_vesting, _initialSupply);
            globalSupply = _initialSupply;
        }
        function core() external view returns(address) {
            return owner();
        }
        function _transferOwnership(address newOwner) internal override {
            if(owner() == address(0)){
                super._transferOwnership(newOwner);
            }else{
                revert OwnableInvalidOwner(newOwner);
            }
        }
        function mint(address _to, uint256 _amount) external onlyMinter {
            _mint(_to, _amount);
            globalSupply += _amount;
        }
        function setMinter(address _minter) external onlyOwner {
            require(!minterFinalized, "minter finalized");
            minter = _minter;
            emit MinterSet(_minter);
        }
        function finalizeMinter() external onlyOwner {
            require(!minterFinalized, "minter finalized");
            minterFinalized = true;
            emit FinalizeMinter();
        }
    }// SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)
    pragma solidity ^0.8.20;
    import {Context} from "../utils/Context.sol";
    /**
     * @dev Contract module which provides a basic access control mechanism, where
     * there is an account (an owner) that can be granted exclusive access to
     * specific functions.
     *
     * The initial owner is set to the address provided by the deployer. This can
     * later be changed with {transferOwnership}.
     *
     * This module is used through inheritance. It will make available the modifier
     * `onlyOwner`, which can be applied to your functions to restrict their use to
     * the owner.
     */
    abstract contract Ownable is Context {
        address private _owner;
        /**
         * @dev The caller account is not authorized to perform an operation.
         */
        error OwnableUnauthorizedAccount(address account);
        /**
         * @dev The owner is not a valid owner account. (eg. `address(0)`)
         */
        error OwnableInvalidOwner(address owner);
        event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
        /**
         * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
         */
        constructor(address initialOwner) {
            if (initialOwner == address(0)) {
                revert OwnableInvalidOwner(address(0));
            }
            _transferOwnership(initialOwner);
        }
        /**
         * @dev Throws if called by any account other than the owner.
         */
        modifier onlyOwner() {
            _checkOwner();
            _;
        }
        /**
         * @dev Returns the address of the current owner.
         */
        function owner() public view virtual returns (address) {
            return _owner;
        }
        /**
         * @dev Throws if the sender is not the owner.
         */
        function _checkOwner() internal view virtual {
            if (owner() != _msgSender()) {
                revert OwnableUnauthorizedAccount(_msgSender());
            }
        }
        /**
         * @dev Leaves the contract without owner. It will not be possible to call
         * `onlyOwner` functions. Can only be called by the current owner.
         *
         * NOTE: Renouncing ownership will leave the contract without an owner,
         * thereby disabling any functionality that is only available to the owner.
         */
        function renounceOwnership() public virtual onlyOwner {
            _transferOwnership(address(0));
        }
        /**
         * @dev Transfers ownership of the contract to a new account (`newOwner`).
         * Can only be called by the current owner.
         */
        function transferOwnership(address newOwner) public virtual onlyOwner {
            if (newOwner == address(0)) {
                revert OwnableInvalidOwner(address(0));
            }
            _transferOwnership(newOwner);
        }
        /**
         * @dev Transfers ownership of the contract to a new account (`newOwner`).
         * Internal function without access restriction.
         */
        function _transferOwnership(address newOwner) internal virtual {
            address oldOwner = _owner;
            _owner = newOwner;
            emit OwnershipTransferred(oldOwner, newOwner);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
    import { IOFT, OFTCore } from "./OFTCore.sol";
    /**
     * @title OFT Contract
     * @dev OFT is an ERC-20 token that extends the functionality of the OFTCore contract.
     */
    abstract contract OFT is OFTCore, ERC20 {
        /**
         * @dev Constructor for the OFT contract.
         * @param _name The name of the OFT.
         * @param _symbol The symbol of the OFT.
         * @param _lzEndpoint The LayerZero endpoint address.
         * @param _delegate The delegate capable of making OApp configurations inside of the endpoint.
         */
        constructor(
            string memory _name,
            string memory _symbol,
            address _lzEndpoint,
            address _delegate
        ) ERC20(_name, _symbol) OFTCore(decimals(), _lzEndpoint, _delegate) {}
        /**
         * @dev Retrieves the address of the underlying ERC20 implementation.
         * @return The address of the OFT token.
         *
         * @dev In the case of OFT, address(this) and erc20 are the same contract.
         */
        function token() public view returns (address) {
            return address(this);
        }
        /**
         * @notice Indicates whether the OFT contract requires approval of the 'token()' to send.
         * @return requiresApproval Needs approval of the underlying token implementation.
         *
         * @dev In the case of OFT where the contract IS the token, approval is NOT required.
         */
        function approvalRequired() external pure virtual returns (bool) {
            return false;
        }
        /**
         * @dev Burns tokens from the sender's specified balance.
         * @param _from The address to debit the tokens from.
         * @param _amountLD The amount of tokens to send in local decimals.
         * @param _minAmountLD The minimum amount to send in local decimals.
         * @param _dstEid The destination chain ID.
         * @return amountSentLD The amount sent in local decimals.
         * @return amountReceivedLD The amount received in local decimals on the remote.
         */
        function _debit(
            address _from,
            uint256 _amountLD,
            uint256 _minAmountLD,
            uint32 _dstEid
        ) internal virtual override returns (uint256 amountSentLD, uint256 amountReceivedLD) {
            (amountSentLD, amountReceivedLD) = _debitView(_amountLD, _minAmountLD, _dstEid);
            // @dev In NON-default OFT, amountSentLD could be 100, with a 10% fee, the amountReceivedLD amount is 90,
            // therefore amountSentLD CAN differ from amountReceivedLD.
            // @dev Default OFT burns on src.
            _burn(_from, amountSentLD);
        }
        /**
         * @dev Credits tokens to the specified address.
         * @param _to The address to credit the tokens to.
         * @param _amountLD The amount of tokens to credit in local decimals.
         * @dev _srcEid The source chain ID.
         * @return amountReceivedLD The amount of tokens ACTUALLY received in local decimals.
         */
        function _credit(
            address _to,
            uint256 _amountLD,
            uint32 /*_srcEid*/
        ) internal virtual override returns (uint256 amountReceivedLD) {
            if (_to == address(0x0)) _to = address(0xdead); // _mint(...) does not support address(0x0)
            // @dev Default OFT mints on dst.
            _mint(_to, _amountLD);
            // @dev In the case of NON-default OFT, the _amountLD MIGHT not be == amountReceivedLD.
            return _amountLD;
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Provides information about the current execution context, including the
     * sender of the transaction and its data. While these are generally available
     * via msg.sender and msg.data, they should not be accessed in such a direct
     * manner, since when dealing with meta-transactions the account sending and
     * paying for execution may not be the actual sender (as far as an application
     * is concerned).
     *
     * This contract is only required for intermediate, library-like contracts.
     */
    abstract contract Context {
        function _msgSender() internal view virtual returns (address) {
            return msg.sender;
        }
        function _msgData() internal view virtual returns (bytes calldata) {
            return msg.data;
        }
        function _contextSuffixLength() internal view virtual returns (uint256) {
            return 0;
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/ERC20.sol)
    pragma solidity ^0.8.20;
    import {IERC20} from "./IERC20.sol";
    import {IERC20Metadata} from "./extensions/IERC20Metadata.sol";
    import {Context} from "../../utils/Context.sol";
    import {IERC20Errors} from "../../interfaces/draft-IERC6093.sol";
    /**
     * @dev Implementation of the {IERC20} interface.
     *
     * This implementation is agnostic to the way tokens are created. This means
     * that a supply mechanism has to be added in a derived contract using {_mint}.
     *
     * TIP: For a detailed writeup see our guide
     * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
     * to implement supply mechanisms].
     *
     * The default value of {decimals} is 18. To change this, you should override
     * this function so it returns a different value.
     *
     * We have followed general OpenZeppelin Contracts guidelines: functions revert
     * instead returning `false` on failure. This behavior is nonetheless
     * conventional and does not conflict with the expectations of ERC-20
     * applications.
     */
    abstract contract ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors {
        mapping(address account => uint256) private _balances;
        mapping(address account => mapping(address spender => uint256)) private _allowances;
        uint256 private _totalSupply;
        string private _name;
        string private _symbol;
        /**
         * @dev Sets the values for {name} and {symbol}.
         *
         * All two of these values are immutable: they can only be set once during
         * construction.
         */
        constructor(string memory name_, string memory symbol_) {
            _name = name_;
            _symbol = symbol_;
        }
        /**
         * @dev Returns the name of the token.
         */
        function name() public view virtual returns (string memory) {
            return _name;
        }
        /**
         * @dev Returns the symbol of the token, usually a shorter version of the
         * name.
         */
        function symbol() public view virtual returns (string memory) {
            return _symbol;
        }
        /**
         * @dev Returns the number of decimals used to get its user representation.
         * For example, if `decimals` equals `2`, a balance of `505` tokens should
         * be displayed to a user as `5.05` (`505 / 10 ** 2`).
         *
         * Tokens usually opt for a value of 18, imitating the relationship between
         * Ether and Wei. This is the default value returned by this function, unless
         * it's overridden.
         *
         * NOTE: This information is only used for _display_ purposes: it in
         * no way affects any of the arithmetic of the contract, including
         * {IERC20-balanceOf} and {IERC20-transfer}.
         */
        function decimals() public view virtual returns (uint8) {
            return 18;
        }
        /**
         * @dev See {IERC20-totalSupply}.
         */
        function totalSupply() public view virtual returns (uint256) {
            return _totalSupply;
        }
        /**
         * @dev See {IERC20-balanceOf}.
         */
        function balanceOf(address account) public view virtual returns (uint256) {
            return _balances[account];
        }
        /**
         * @dev See {IERC20-transfer}.
         *
         * Requirements:
         *
         * - `to` cannot be the zero address.
         * - the caller must have a balance of at least `value`.
         */
        function transfer(address to, uint256 value) public virtual returns (bool) {
            address owner = _msgSender();
            _transfer(owner, to, value);
            return true;
        }
        /**
         * @dev See {IERC20-allowance}.
         */
        function allowance(address owner, address spender) public view virtual returns (uint256) {
            return _allowances[owner][spender];
        }
        /**
         * @dev See {IERC20-approve}.
         *
         * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on
         * `transferFrom`. This is semantically equivalent to an infinite approval.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function approve(address spender, uint256 value) public virtual returns (bool) {
            address owner = _msgSender();
            _approve(owner, spender, value);
            return true;
        }
        /**
         * @dev See {IERC20-transferFrom}.
         *
         * Skips emitting an {Approval} event indicating an allowance update. This is not
         * required by the ERC. See {xref-ERC20-_approve-address-address-uint256-bool-}[_approve].
         *
         * NOTE: Does not update the allowance if the current allowance
         * is the maximum `uint256`.
         *
         * Requirements:
         *
         * - `from` and `to` cannot be the zero address.
         * - `from` must have a balance of at least `value`.
         * - the caller must have allowance for ``from``'s tokens of at least
         * `value`.
         */
        function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
            address spender = _msgSender();
            _spendAllowance(from, spender, value);
            _transfer(from, to, value);
            return true;
        }
        /**
         * @dev Moves a `value` amount of tokens from `from` to `to`.
         *
         * This internal function is equivalent to {transfer}, and can be used to
         * e.g. implement automatic token fees, slashing mechanisms, etc.
         *
         * Emits a {Transfer} event.
         *
         * NOTE: This function is not virtual, {_update} should be overridden instead.
         */
        function _transfer(address from, address to, uint256 value) internal {
            if (from == address(0)) {
                revert ERC20InvalidSender(address(0));
            }
            if (to == address(0)) {
                revert ERC20InvalidReceiver(address(0));
            }
            _update(from, to, value);
        }
        /**
         * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
         * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
         * this function.
         *
         * Emits a {Transfer} event.
         */
        function _update(address from, address to, uint256 value) internal virtual {
            if (from == address(0)) {
                // Overflow check required: The rest of the code assumes that totalSupply never overflows
                _totalSupply += value;
            } else {
                uint256 fromBalance = _balances[from];
                if (fromBalance < value) {
                    revert ERC20InsufficientBalance(from, fromBalance, value);
                }
                unchecked {
                    // Overflow not possible: value <= fromBalance <= totalSupply.
                    _balances[from] = fromBalance - value;
                }
            }
            if (to == address(0)) {
                unchecked {
                    // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                    _totalSupply -= value;
                }
            } else {
                unchecked {
                    // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                    _balances[to] += value;
                }
            }
            emit Transfer(from, to, value);
        }
        /**
         * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
         * Relies on the `_update` mechanism
         *
         * Emits a {Transfer} event with `from` set to the zero address.
         *
         * NOTE: This function is not virtual, {_update} should be overridden instead.
         */
        function _mint(address account, uint256 value) internal {
            if (account == address(0)) {
                revert ERC20InvalidReceiver(address(0));
            }
            _update(address(0), account, value);
        }
        /**
         * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
         * Relies on the `_update` mechanism.
         *
         * Emits a {Transfer} event with `to` set to the zero address.
         *
         * NOTE: This function is not virtual, {_update} should be overridden instead
         */
        function _burn(address account, uint256 value) internal {
            if (account == address(0)) {
                revert ERC20InvalidSender(address(0));
            }
            _update(account, address(0), value);
        }
        /**
         * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens.
         *
         * This internal function is equivalent to `approve`, and can be used to
         * e.g. set automatic allowances for certain subsystems, etc.
         *
         * Emits an {Approval} event.
         *
         * Requirements:
         *
         * - `owner` cannot be the zero address.
         * - `spender` cannot be the zero address.
         *
         * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
         */
        function _approve(address owner, address spender, uint256 value) internal {
            _approve(owner, spender, value, true);
        }
        /**
         * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
         *
         * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
         * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any
         * `Approval` event during `transferFrom` operations.
         *
         * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to
         * true using the following override:
         *
         * ```solidity
         * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
         *     super._approve(owner, spender, value, true);
         * }
         * ```
         *
         * Requirements are the same as {_approve}.
         */
        function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
            if (owner == address(0)) {
                revert ERC20InvalidApprover(address(0));
            }
            if (spender == address(0)) {
                revert ERC20InvalidSpender(address(0));
            }
            _allowances[owner][spender] = value;
            if (emitEvent) {
                emit Approval(owner, spender, value);
            }
        }
        /**
         * @dev Updates `owner` s allowance for `spender` based on spent `value`.
         *
         * Does not update the allowance value in case of infinite allowance.
         * Revert if not enough allowance is available.
         *
         * Does not emit an {Approval} event.
         */
        function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
            uint256 currentAllowance = allowance(owner, spender);
            if (currentAllowance != type(uint256).max) {
                if (currentAllowance < value) {
                    revert ERC20InsufficientAllowance(spender, currentAllowance, value);
                }
                unchecked {
                    _approve(owner, spender, currentAllowance - value, false);
                }
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
    import { OApp, Origin } from "@layerzerolabs/oapp-evm/contracts/oapp/OApp.sol";
    import { OAppOptionsType3 } from "@layerzerolabs/oapp-evm/contracts/oapp/libs/OAppOptionsType3.sol";
    import { IOAppMsgInspector } from "@layerzerolabs/oapp-evm/contracts/oapp/interfaces/IOAppMsgInspector.sol";
    import { OAppPreCrimeSimulator } from "@layerzerolabs/oapp-evm/contracts/precrime/OAppPreCrimeSimulator.sol";
    import { IOFT, SendParam, OFTLimit, OFTReceipt, OFTFeeDetail, MessagingReceipt, MessagingFee } from "./interfaces/IOFT.sol";
    import { OFTMsgCodec } from "./libs/OFTMsgCodec.sol";
    import { OFTComposeMsgCodec } from "./libs/OFTComposeMsgCodec.sol";
    /**
     * @title OFTCore
     * @dev Abstract contract for the OftChain (OFT) token.
     */
    abstract contract OFTCore is IOFT, OApp, OAppPreCrimeSimulator, OAppOptionsType3 {
        using OFTMsgCodec for bytes;
        using OFTMsgCodec for bytes32;
        // @notice Provides a conversion rate when swapping between denominations of SD and LD
        //      - shareDecimals == SD == shared Decimals
        //      - localDecimals == LD == local decimals
        // @dev Considers that tokens have different decimal amounts on various chains.
        // @dev eg.
        //  For a token
        //      - locally with 4 decimals --> 1.2345 => uint(12345)
        //      - remotely with 2 decimals --> 1.23 => uint(123)
        //      - The conversion rate would be 10 ** (4 - 2) = 100
        //  @dev If you want to send 1.2345 -> (uint 12345), you CANNOT represent that value on the remote,
        //  you can only display 1.23 -> uint(123).
        //  @dev To preserve the dust that would otherwise be lost on that conversion,
        //  we need to unify a denomination that can be represented on ALL chains inside of the OFT mesh
        uint256 public immutable decimalConversionRate;
        // @notice Msg types that are used to identify the various OFT operations.
        // @dev This can be extended in child contracts for non-default oft operations
        // @dev These values are used in things like combineOptions() in OAppOptionsType3.sol.
        uint16 public constant SEND = 1;
        uint16 public constant SEND_AND_CALL = 2;
        // Address of an optional contract to inspect both 'message' and 'options'
        address public msgInspector;
        event MsgInspectorSet(address inspector);
        /**
         * @dev Constructor.
         * @param _localDecimals The decimals of the token on the local chain (this chain).
         * @param _endpoint The address of the LayerZero endpoint.
         * @param _delegate The delegate capable of making OApp configurations inside of the endpoint.
         */
        constructor(uint8 _localDecimals, address _endpoint, address _delegate) OApp(_endpoint, _delegate) {
            if (_localDecimals < sharedDecimals()) revert InvalidLocalDecimals();
            decimalConversionRate = 10 ** (_localDecimals - sharedDecimals());
        }
        /**
         * @notice Retrieves interfaceID and the version of the OFT.
         * @return interfaceId The interface ID.
         * @return version The version.
         *
         * @dev interfaceId: This specific interface ID is '0x02e49c2c'.
         * @dev version: Indicates a cross-chain compatible msg encoding with other OFTs.
         * @dev If a new feature is added to the OFT cross-chain msg encoding, the version will be incremented.
         * ie. localOFT version(x,1) CAN send messages to remoteOFT version(x,1)
         */
        function oftVersion() external pure virtual returns (bytes4 interfaceId, uint64 version) {
            return (type(IOFT).interfaceId, 1);
        }
        /**
         * @dev Retrieves the shared decimals of the OFT.
         * @return The shared decimals of the OFT.
         *
         * @dev Sets an implicit cap on the amount of tokens, over uint64.max() will need some sort of outbound cap / totalSupply cap
         * Lowest common decimal denominator between chains.
         * Defaults to 6 decimal places to provide up to 18,446,744,073,709.551615 units (max uint64).
         * For tokens exceeding this totalSupply(), they will need to override the sharedDecimals function with something smaller.
         * ie. 4 sharedDecimals would be 1,844,674,407,370,955.1615
         */
        function sharedDecimals() public view virtual returns (uint8) {
            return 6;
        }
        /**
         * @dev Sets the message inspector address for the OFT.
         * @param _msgInspector The address of the message inspector.
         *
         * @dev This is an optional contract that can be used to inspect both 'message' and 'options'.
         * @dev Set it to address(0) to disable it, or set it to a contract address to enable it.
         */
        function setMsgInspector(address _msgInspector) public virtual onlyOwner {
            msgInspector = _msgInspector;
            emit MsgInspectorSet(_msgInspector);
        }
        /**
         * @notice Provides the fee breakdown and settings data for an OFT. Unused in the default implementation.
         * @param _sendParam The parameters for the send operation.
         * @return oftLimit The OFT limit information.
         * @return oftFeeDetails The details of OFT fees.
         * @return oftReceipt The OFT receipt information.
         */
        function quoteOFT(
            SendParam calldata _sendParam
        )
            external
            view
            virtual
            returns (OFTLimit memory oftLimit, OFTFeeDetail[] memory oftFeeDetails, OFTReceipt memory oftReceipt)
        {
            uint256 minAmountLD = 0; // Unused in the default implementation.
            uint256 maxAmountLD = IERC20(this.token()).totalSupply(); // Unused in the default implementation.
            oftLimit = OFTLimit(minAmountLD, maxAmountLD);
            // Unused in the default implementation; reserved for future complex fee details.
            oftFeeDetails = new OFTFeeDetail[](0);
            // @dev This is the same as the send() operation, but without the actual send.
            // - amountSentLD is the amount in local decimals that would be sent from the sender.
            // - amountReceivedLD is the amount in local decimals that will be credited to the recipient on the remote OFT instance.
            // @dev The amountSentLD MIGHT not equal the amount the user actually receives. HOWEVER, the default does.
            (uint256 amountSentLD, uint256 amountReceivedLD) = _debitView(
                _sendParam.amountLD,
                _sendParam.minAmountLD,
                _sendParam.dstEid
            );
            oftReceipt = OFTReceipt(amountSentLD, amountReceivedLD);
        }
        /**
         * @notice Provides a quote for the send() operation.
         * @param _sendParam The parameters for the send() operation.
         * @param _payInLzToken Flag indicating whether the caller is paying in the LZ token.
         * @return msgFee The calculated LayerZero messaging fee from the send() operation.
         *
         * @dev MessagingFee: LayerZero msg fee
         *  - nativeFee: The native fee.
         *  - lzTokenFee: The lzToken fee.
         */
        function quoteSend(
            SendParam calldata _sendParam,
            bool _payInLzToken
        ) external view virtual returns (MessagingFee memory msgFee) {
            // @dev mock the amount to receive, this is the same operation used in the send().
            // The quote is as similar as possible to the actual send() operation.
            (, uint256 amountReceivedLD) = _debitView(_sendParam.amountLD, _sendParam.minAmountLD, _sendParam.dstEid);
            // @dev Builds the options and OFT message to quote in the endpoint.
            (bytes memory message, bytes memory options) = _buildMsgAndOptions(_sendParam, amountReceivedLD);
            // @dev Calculates the LayerZero fee for the send() operation.
            return _quote(_sendParam.dstEid, message, options, _payInLzToken);
        }
        /**
         * @dev Executes the send operation.
         * @param _sendParam The parameters for the send operation.
         * @param _fee The calculated fee for the send() operation.
         *      - nativeFee: The native fee.
         *      - lzTokenFee: The lzToken fee.
         * @param _refundAddress The address to receive any excess funds.
         * @return msgReceipt The receipt for the send operation.
         * @return oftReceipt The OFT receipt information.
         *
         * @dev MessagingReceipt: LayerZero msg receipt
         *  - guid: The unique identifier for the sent message.
         *  - nonce: The nonce of the sent message.
         *  - fee: The LayerZero fee incurred for the message.
         */
        function send(
            SendParam calldata _sendParam,
            MessagingFee calldata _fee,
            address _refundAddress
        ) external payable virtual returns (MessagingReceipt memory msgReceipt, OFTReceipt memory oftReceipt) {
            return _send(_sendParam, _fee, _refundAddress);
        }
        /**
         * @dev Internal function to execute the send operation.
         * @param _sendParam The parameters for the send operation.
         * @param _fee The calculated fee for the send() operation.
         *      - nativeFee: The native fee.
         *      - lzTokenFee: The lzToken fee.
         * @param _refundAddress The address to receive any excess funds.
         * @return msgReceipt The receipt for the send operation.
         * @return oftReceipt The OFT receipt information.
         *
         * @dev MessagingReceipt: LayerZero msg receipt
         *  - guid: The unique identifier for the sent message.
         *  - nonce: The nonce of the sent message.
         *  - fee: The LayerZero fee incurred for the message.
         */
        function _send(
            SendParam calldata _sendParam,
            MessagingFee calldata _fee,
            address _refundAddress
        ) internal virtual returns (MessagingReceipt memory msgReceipt, OFTReceipt memory oftReceipt) {
            // @dev Applies the token transfers regarding this send() operation.
            // - amountSentLD is the amount in local decimals that was ACTUALLY sent/debited from the sender.
            // - amountReceivedLD is the amount in local decimals that will be received/credited to the recipient on the remote OFT instance.
            (uint256 amountSentLD, uint256 amountReceivedLD) = _debit(
                msg.sender,
                _sendParam.amountLD,
                _sendParam.minAmountLD,
                _sendParam.dstEid
            );
            // @dev Builds the options and OFT message to quote in the endpoint.
            (bytes memory message, bytes memory options) = _buildMsgAndOptions(_sendParam, amountReceivedLD);
            // @dev Sends the message to the LayerZero endpoint and returns the LayerZero msg receipt.
            msgReceipt = _lzSend(_sendParam.dstEid, message, options, _fee, _refundAddress);
            // @dev Formulate the OFT receipt.
            oftReceipt = OFTReceipt(amountSentLD, amountReceivedLD);
            emit OFTSent(msgReceipt.guid, _sendParam.dstEid, msg.sender, amountSentLD, amountReceivedLD);
        }
        /**
         * @dev Internal function to build the message and options.
         * @param _sendParam The parameters for the send() operation.
         * @param _amountLD The amount in local decimals.
         * @return message The encoded message.
         * @return options The encoded options.
         */
        function _buildMsgAndOptions(
            SendParam calldata _sendParam,
            uint256 _amountLD
        ) internal view virtual returns (bytes memory message, bytes memory options) {
            bool hasCompose;
            // @dev This generated message has the msg.sender encoded into the payload so the remote knows who the caller is.
            (message, hasCompose) = OFTMsgCodec.encode(
                _sendParam.to,
                _toSD(_amountLD),
                // @dev Must be include a non empty bytes if you want to compose, EVEN if you dont need it on the remote.
                // EVEN if you dont require an arbitrary payload to be sent... eg. '0x01'
                _sendParam.composeMsg
            );
            // @dev Change the msg type depending if its composed or not.
            uint16 msgType = hasCompose ? SEND_AND_CALL : SEND;
            // @dev Combine the callers _extraOptions with the enforced options via the OAppOptionsType3.
            options = combineOptions(_sendParam.dstEid, msgType, _sendParam.extraOptions);
            // @dev Optionally inspect the message and options depending if the OApp owner has set a msg inspector.
            // @dev If it fails inspection, needs to revert in the implementation. ie. does not rely on return boolean
            address inspector = msgInspector; // caches the msgInspector to avoid potential double storage read
            if (inspector != address(0)) IOAppMsgInspector(inspector).inspect(message, options);
        }
        /**
         * @dev Internal function to handle the receive on the LayerZero endpoint.
         * @param _origin The origin information.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address from the src chain.
         *  - nonce: The nonce of the LayerZero message.
         * @param _guid The unique identifier for the received LayerZero message.
         * @param _message The encoded message.
         * @dev _executor The address of the executor.
         * @dev _extraData Additional data.
         */
        function _lzReceive(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address /*_executor*/, // @dev unused in the default implementation.
            bytes calldata /*_extraData*/ // @dev unused in the default implementation.
        ) internal virtual override {
            // @dev The src sending chain doesnt know the address length on this chain (potentially non-evm)
            // Thus everything is bytes32() encoded in flight.
            address toAddress = _message.sendTo().bytes32ToAddress();
            // @dev Credit the amountLD to the recipient and return the ACTUAL amount the recipient received in local decimals
            uint256 amountReceivedLD = _credit(toAddress, _toLD(_message.amountSD()), _origin.srcEid);
            if (_message.isComposed()) {
                // @dev Proprietary composeMsg format for the OFT.
                bytes memory composeMsg = OFTComposeMsgCodec.encode(
                    _origin.nonce,
                    _origin.srcEid,
                    amountReceivedLD,
                    _message.composeMsg()
                );
                // @dev Stores the lzCompose payload that will be executed in a separate tx.
                // Standardizes functionality for executing arbitrary contract invocation on some non-evm chains.
                // @dev The off-chain executor will listen and process the msg based on the src-chain-callers compose options passed.
                // @dev The index is used when a OApp needs to compose multiple msgs on lzReceive.
                // For default OFT implementation there is only 1 compose msg per lzReceive, thus its always 0.
                endpoint.sendCompose(toAddress, _guid, 0 /* the index of the composed message*/, composeMsg);
            }
            emit OFTReceived(_guid, _origin.srcEid, toAddress, amountReceivedLD);
        }
        /**
         * @dev Internal function to handle the OAppPreCrimeSimulator simulated receive.
         * @param _origin The origin information.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address from the src chain.
         *  - nonce: The nonce of the LayerZero message.
         * @param _guid The unique identifier for the received LayerZero message.
         * @param _message The LayerZero message.
         * @param _executor The address of the off-chain executor.
         * @param _extraData Arbitrary data passed by the msg executor.
         *
         * @dev Enables the preCrime simulator to mock sending lzReceive() messages,
         * routes the msg down from the OAppPreCrimeSimulator, and back up to the OAppReceiver.
         */
        function _lzReceiveSimulate(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address _executor,
            bytes calldata _extraData
        ) internal virtual override {
            _lzReceive(_origin, _guid, _message, _executor, _extraData);
        }
        /**
         * @dev Check if the peer is considered 'trusted' by the OApp.
         * @param _eid The endpoint ID to check.
         * @param _peer The peer to check.
         * @return Whether the peer passed is considered 'trusted' by the OApp.
         *
         * @dev Enables OAppPreCrimeSimulator to check whether a potential Inbound Packet is from a trusted source.
         */
        function isPeer(uint32 _eid, bytes32 _peer) public view virtual override returns (bool) {
            return peers[_eid] == _peer;
        }
        /**
         * @dev Internal function to remove dust from the given local decimal amount.
         * @param _amountLD The amount in local decimals.
         * @return amountLD The amount after removing dust.
         *
         * @dev Prevents the loss of dust when moving amounts between chains with different decimals.
         * @dev eg. uint(123) with a conversion rate of 100 becomes uint(100).
         */
        function _removeDust(uint256 _amountLD) internal view virtual returns (uint256 amountLD) {
            return (_amountLD / decimalConversionRate) * decimalConversionRate;
        }
        /**
         * @dev Internal function to convert an amount from shared decimals into local decimals.
         * @param _amountSD The amount in shared decimals.
         * @return amountLD The amount in local decimals.
         */
        function _toLD(uint64 _amountSD) internal view virtual returns (uint256 amountLD) {
            return _amountSD * decimalConversionRate;
        }
        /**
         * @dev Internal function to convert an amount from local decimals into shared decimals.
         * @param _amountLD The amount in local decimals.
         * @return amountSD The amount in shared decimals.
         */
        function _toSD(uint256 _amountLD) internal view virtual returns (uint64 amountSD) {
            return uint64(_amountLD / decimalConversionRate);
        }
        /**
         * @dev Internal function to mock the amount mutation from a OFT debit() operation.
         * @param _amountLD The amount to send in local decimals.
         * @param _minAmountLD The minimum amount to send in local decimals.
         * @dev _dstEid The destination endpoint ID.
         * @return amountSentLD The amount sent, in local decimals.
         * @return amountReceivedLD The amount to be received on the remote chain, in local decimals.
         *
         * @dev This is where things like fees would be calculated and deducted from the amount to be received on the remote.
         */
        function _debitView(
            uint256 _amountLD,
            uint256 _minAmountLD,
            uint32 /*_dstEid*/
        ) internal view virtual returns (uint256 amountSentLD, uint256 amountReceivedLD) {
            // @dev Remove the dust so nothing is lost on the conversion between chains with different decimals for the token.
            amountSentLD = _removeDust(_amountLD);
            // @dev The amount to send is the same as amount received in the default implementation.
            amountReceivedLD = amountSentLD;
            // @dev Check for slippage.
            if (amountReceivedLD < _minAmountLD) {
                revert SlippageExceeded(amountReceivedLD, _minAmountLD);
            }
        }
        /**
         * @dev Internal function to perform a debit operation.
         * @param _from The address to debit.
         * @param _amountLD The amount to send in local decimals.
         * @param _minAmountLD The minimum amount to send in local decimals.
         * @param _dstEid The destination endpoint ID.
         * @return amountSentLD The amount sent in local decimals.
         * @return amountReceivedLD The amount received in local decimals on the remote.
         *
         * @dev Defined here but are intended to be overriden depending on the OFT implementation.
         * @dev Depending on OFT implementation the _amountLD could differ from the amountReceivedLD.
         */
        function _debit(
            address _from,
            uint256 _amountLD,
            uint256 _minAmountLD,
            uint32 _dstEid
        ) internal virtual returns (uint256 amountSentLD, uint256 amountReceivedLD);
        /**
         * @dev Internal function to perform a credit operation.
         * @param _to The address to credit.
         * @param _amountLD The amount to credit in local decimals.
         * @param _srcEid The source endpoint ID.
         * @return amountReceivedLD The amount ACTUALLY received in local decimals.
         *
         * @dev Defined here but are intended to be overriden depending on the OFT implementation.
         * @dev Depending on OFT implementation the _amountLD could differ from the amountReceivedLD.
         */
        function _credit(
            address _to,
            uint256 _amountLD,
            uint32 _srcEid
        ) internal virtual returns (uint256 amountReceivedLD);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Interface of the ERC-20 standard as defined in the ERC.
     */
    interface IERC20 {
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
        /**
         * @dev Returns the value of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the value of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves a `value` amount of tokens from the caller's account to `to`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address to, uint256 value) 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 a `value` amount of tokens 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 value) external returns (bool);
        /**
         * @dev Moves a `value` amount of tokens from `from` to `to` using the
         * allowance mechanism. `value` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address from, address to, uint256 value) external returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/extensions/IERC20Metadata.sol)
    pragma solidity ^0.8.20;
    import {IERC20} from "../IERC20.sol";
    /**
     * @dev Interface for the optional metadata functions from the ERC-20 standard.
     */
    interface IERC20Metadata is IERC20 {
        /**
         * @dev Returns the name of the token.
         */
        function name() external view returns (string memory);
        /**
         * @dev Returns the symbol of the token.
         */
        function symbol() external view returns (string memory);
        /**
         * @dev Returns the decimals places of the token.
         */
        function decimals() external view returns (uint8);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (interfaces/draft-IERC6093.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Standard ERC-20 Errors
     * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-20 tokens.
     */
    interface IERC20Errors {
        /**
         * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
         * @param sender Address whose tokens are being transferred.
         * @param balance Current balance for the interacting account.
         * @param needed Minimum amount required to perform a transfer.
         */
        error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);
        /**
         * @dev Indicates a failure with the token `sender`. Used in transfers.
         * @param sender Address whose tokens are being transferred.
         */
        error ERC20InvalidSender(address sender);
        /**
         * @dev Indicates a failure with the token `receiver`. Used in transfers.
         * @param receiver Address to which tokens are being transferred.
         */
        error ERC20InvalidReceiver(address receiver);
        /**
         * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
         * @param spender Address that may be allowed to operate on tokens without being their owner.
         * @param allowance Amount of tokens a `spender` is allowed to operate with.
         * @param needed Minimum amount required to perform a transfer.
         */
        error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);
        /**
         * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
         * @param approver Address initiating an approval operation.
         */
        error ERC20InvalidApprover(address approver);
        /**
         * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
         * @param spender Address that may be allowed to operate on tokens without being their owner.
         */
        error ERC20InvalidSpender(address spender);
    }
    /**
     * @dev Standard ERC-721 Errors
     * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-721 tokens.
     */
    interface IERC721Errors {
        /**
         * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in ERC-20.
         * Used in balance queries.
         * @param owner Address of the current owner of a token.
         */
        error ERC721InvalidOwner(address owner);
        /**
         * @dev Indicates a `tokenId` whose `owner` is the zero address.
         * @param tokenId Identifier number of a token.
         */
        error ERC721NonexistentToken(uint256 tokenId);
        /**
         * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
         * @param sender Address whose tokens are being transferred.
         * @param tokenId Identifier number of a token.
         * @param owner Address of the current owner of a token.
         */
        error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);
        /**
         * @dev Indicates a failure with the token `sender`. Used in transfers.
         * @param sender Address whose tokens are being transferred.
         */
        error ERC721InvalidSender(address sender);
        /**
         * @dev Indicates a failure with the token `receiver`. Used in transfers.
         * @param receiver Address to which tokens are being transferred.
         */
        error ERC721InvalidReceiver(address receiver);
        /**
         * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
         * @param operator Address that may be allowed to operate on tokens without being their owner.
         * @param tokenId Identifier number of a token.
         */
        error ERC721InsufficientApproval(address operator, uint256 tokenId);
        /**
         * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
         * @param approver Address initiating an approval operation.
         */
        error ERC721InvalidApprover(address approver);
        /**
         * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
         * @param operator Address that may be allowed to operate on tokens without being their owner.
         */
        error ERC721InvalidOperator(address operator);
    }
    /**
     * @dev Standard ERC-1155 Errors
     * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-1155 tokens.
     */
    interface IERC1155Errors {
        /**
         * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
         * @param sender Address whose tokens are being transferred.
         * @param balance Current balance for the interacting account.
         * @param needed Minimum amount required to perform a transfer.
         * @param tokenId Identifier number of a token.
         */
        error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);
        /**
         * @dev Indicates a failure with the token `sender`. Used in transfers.
         * @param sender Address whose tokens are being transferred.
         */
        error ERC1155InvalidSender(address sender);
        /**
         * @dev Indicates a failure with the token `receiver`. Used in transfers.
         * @param receiver Address to which tokens are being transferred.
         */
        error ERC1155InvalidReceiver(address receiver);
        /**
         * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
         * @param operator Address that may be allowed to operate on tokens without being their owner.
         * @param owner Address of the current owner of a token.
         */
        error ERC1155MissingApprovalForAll(address operator, address owner);
        /**
         * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
         * @param approver Address initiating an approval operation.
         */
        error ERC1155InvalidApprover(address approver);
        /**
         * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
         * @param operator Address that may be allowed to operate on tokens without being their owner.
         */
        error ERC1155InvalidOperator(address operator);
        /**
         * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
         * Used in batch transfers.
         * @param idsLength Length of the array of token identifiers
         * @param valuesLength Length of the array of token amounts
         */
        error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    // @dev Import the 'MessagingFee' and 'MessagingReceipt' so it's exposed to OApp implementers
    // solhint-disable-next-line no-unused-import
    import { OAppSender, MessagingFee, MessagingReceipt } from "./OAppSender.sol";
    // @dev Import the 'Origin' so it's exposed to OApp implementers
    // solhint-disable-next-line no-unused-import
    import { OAppReceiver, Origin } from "./OAppReceiver.sol";
    import { OAppCore } from "./OAppCore.sol";
    /**
     * @title OApp
     * @dev Abstract contract serving as the base for OApp implementation, combining OAppSender and OAppReceiver functionality.
     */
    abstract contract OApp is OAppSender, OAppReceiver {
        /**
         * @dev Constructor to initialize the OApp with the provided endpoint and owner.
         * @param _endpoint The address of the LOCAL LayerZero endpoint.
         * @param _delegate The delegate capable of making OApp configurations inside of the endpoint.
         */
        constructor(address _endpoint, address _delegate) OAppCore(_endpoint, _delegate) {}
        /**
         * @notice Retrieves the OApp version information.
         * @return senderVersion The version of the OAppSender.sol implementation.
         * @return receiverVersion The version of the OAppReceiver.sol implementation.
         */
        function oAppVersion()
            public
            pure
            virtual
            override(OAppSender, OAppReceiver)
            returns (uint64 senderVersion, uint64 receiverVersion)
        {
            return (SENDER_VERSION, RECEIVER_VERSION);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";
    import { IOAppOptionsType3, EnforcedOptionParam } from "../interfaces/IOAppOptionsType3.sol";
    /**
     * @title OAppOptionsType3
     * @dev Abstract contract implementing the IOAppOptionsType3 interface with type 3 options.
     */
    abstract contract OAppOptionsType3 is IOAppOptionsType3, Ownable {
        uint16 internal constant OPTION_TYPE_3 = 3;
        // @dev The "msgType" should be defined in the child contract.
        mapping(uint32 eid => mapping(uint16 msgType => bytes enforcedOption)) public enforcedOptions;
        /**
         * @dev Sets the enforced options for specific endpoint and message type combinations.
         * @param _enforcedOptions An array of EnforcedOptionParam structures specifying enforced options.
         *
         * @dev Only the owner/admin of the OApp can call this function.
         * @dev Provides a way for the OApp to enforce things like paying for PreCrime, AND/OR minimum dst lzReceive gas amounts etc.
         * @dev These enforced options can vary as the potential options/execution on the remote may differ as per the msgType.
         * eg. Amount of lzReceive() gas necessary to deliver a lzCompose() message adds overhead you dont want to pay
         * if you are only making a standard LayerZero message ie. lzReceive() WITHOUT sendCompose().
         */
        function setEnforcedOptions(EnforcedOptionParam[] calldata _enforcedOptions) public virtual onlyOwner {
            _setEnforcedOptions(_enforcedOptions);
        }
        /**
         * @dev Sets the enforced options for specific endpoint and message type combinations.
         * @param _enforcedOptions An array of EnforcedOptionParam structures specifying enforced options.
         *
         * @dev Provides a way for the OApp to enforce things like paying for PreCrime, AND/OR minimum dst lzReceive gas amounts etc.
         * @dev These enforced options can vary as the potential options/execution on the remote may differ as per the msgType.
         * eg. Amount of lzReceive() gas necessary to deliver a lzCompose() message adds overhead you dont want to pay
         * if you are only making a standard LayerZero message ie. lzReceive() WITHOUT sendCompose().
         */
        function _setEnforcedOptions(EnforcedOptionParam[] memory _enforcedOptions) internal virtual {
            for (uint256 i = 0; i < _enforcedOptions.length; i++) {
                // @dev Enforced options are only available for optionType 3, as type 1 and 2 dont support combining.
                _assertOptionsType3(_enforcedOptions[i].options);
                enforcedOptions[_enforcedOptions[i].eid][_enforcedOptions[i].msgType] = _enforcedOptions[i].options;
            }
            emit EnforcedOptionSet(_enforcedOptions);
        }
        /**
         * @notice Combines options for a given endpoint and message type.
         * @param _eid The endpoint ID.
         * @param _msgType The OAPP message type.
         * @param _extraOptions Additional options passed by the caller.
         * @return options The combination of caller specified options AND enforced options.
         *
         * @dev If there is an enforced lzReceive option:
         * - {gasLimit: 200k, msg.value: 1 ether} AND a caller supplies a lzReceive option: {gasLimit: 100k, msg.value: 0.5 ether}
         * - The resulting options will be {gasLimit: 300k, msg.value: 1.5 ether} when the message is executed on the remote lzReceive() function.
         * @dev This presence of duplicated options is handled off-chain in the verifier/executor.
         */
        function combineOptions(
            uint32 _eid,
            uint16 _msgType,
            bytes calldata _extraOptions
        ) public view virtual returns (bytes memory) {
            bytes memory enforced = enforcedOptions[_eid][_msgType];
            // No enforced options, pass whatever the caller supplied, even if it's empty or legacy type 1/2 options.
            if (enforced.length == 0) return _extraOptions;
            // No caller options, return enforced
            if (_extraOptions.length == 0) return enforced;
            // @dev If caller provided _extraOptions, must be type 3 as its the ONLY type that can be combined.
            if (_extraOptions.length >= 2) {
                _assertOptionsType3(_extraOptions);
                // @dev Remove the first 2 bytes containing the type from the _extraOptions and combine with enforced.
                return bytes.concat(enforced, _extraOptions[2:]);
            }
            // No valid set of options was found.
            revert InvalidOptions(_extraOptions);
        }
        /**
         * @dev Internal function to assert that options are of type 3.
         * @param _options The options to be checked.
         */
        function _assertOptionsType3(bytes memory _options) internal pure virtual {
            uint16 optionsType;
            assembly {
                optionsType := mload(add(_options, 2))
            }
            if (optionsType != OPTION_TYPE_3) revert InvalidOptions(_options);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    /**
     * @title IOAppMsgInspector
     * @dev Interface for the OApp Message Inspector, allowing examination of message and options contents.
     */
    interface IOAppMsgInspector {
        // Custom error message for inspection failure
        error InspectionFailed(bytes message, bytes options);
        /**
         * @notice Allows the inspector to examine LayerZero message contents and optionally throw a revert if invalid.
         * @param _message The message payload to be inspected.
         * @param _options Additional options or parameters for inspection.
         * @return valid A boolean indicating whether the inspection passed (true) or failed (false).
         *
         * @dev Optionally done as a revert, OR use the boolean provided to handle the failure.
         */
        function inspect(bytes calldata _message, bytes calldata _options) external view returns (bool valid);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";
    import { IPreCrime } from "./interfaces/IPreCrime.sol";
    import { IOAppPreCrimeSimulator, InboundPacket, Origin } from "./interfaces/IOAppPreCrimeSimulator.sol";
    /**
     * @title OAppPreCrimeSimulator
     * @dev Abstract contract serving as the base for preCrime simulation functionality in an OApp.
     */
    abstract contract OAppPreCrimeSimulator is IOAppPreCrimeSimulator, Ownable {
        // The address of the preCrime implementation.
        address public preCrime;
        /**
         * @dev Retrieves the address of the OApp contract.
         * @return The address of the OApp contract.
         *
         * @dev The simulator contract is the base contract for the OApp by default.
         * @dev If the simulator is a separate contract, override this function.
         */
        function oApp() external view virtual returns (address) {
            return address(this);
        }
        /**
         * @dev Sets the preCrime contract address.
         * @param _preCrime The address of the preCrime contract.
         */
        function setPreCrime(address _preCrime) public virtual onlyOwner {
            preCrime = _preCrime;
            emit PreCrimeSet(_preCrime);
        }
        /**
         * @dev Interface for pre-crime simulations. Always reverts at the end with the simulation results.
         * @param _packets An array of InboundPacket objects representing received packets to be delivered.
         *
         * @dev WARNING: MUST revert at the end with the simulation results.
         * @dev Gives the preCrime implementation the ability to mock sending packets to the lzReceive function,
         * WITHOUT actually executing them.
         */
        function lzReceiveAndRevert(InboundPacket[] calldata _packets) public payable virtual {
            for (uint256 i = 0; i < _packets.length; i++) {
                InboundPacket calldata packet = _packets[i];
                // Ignore packets that are not from trusted peers.
                if (!isPeer(packet.origin.srcEid, packet.origin.sender)) continue;
                // @dev Because a verifier is calling this function, it doesnt have access to executor params:
                //  - address _executor
                //  - bytes calldata _extraData
                // preCrime will NOT work for OApps that rely on these two parameters inside of their _lzReceive().
                // They are instead stubbed to default values, address(0) and bytes("")
                // @dev Calling this.lzReceiveSimulate removes ability for assembly return 0 callstack exit,
                // which would cause the revert to be ignored.
                this.lzReceiveSimulate{ value: packet.value }(
                    packet.origin,
                    packet.guid,
                    packet.message,
                    packet.executor,
                    packet.extraData
                );
            }
            // @dev Revert with the simulation results. msg.sender must implement IPreCrime.buildSimulationResult().
            revert SimulationResult(IPreCrime(msg.sender).buildSimulationResult());
        }
        /**
         * @dev Is effectively an internal function because msg.sender must be address(this).
         * Allows resetting the call stack for 'internal' calls.
         * @param _origin The origin information containing the source endpoint and sender address.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address on the src chain.
         *  - nonce: The nonce of the message.
         * @param _guid The unique identifier of the packet.
         * @param _message The message payload of the packet.
         * @param _executor The executor address for the packet.
         * @param _extraData Additional data for the packet.
         */
        function lzReceiveSimulate(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address _executor,
            bytes calldata _extraData
        ) external payable virtual {
            // @dev Ensure ONLY can be called 'internally'.
            if (msg.sender != address(this)) revert OnlySelf();
            _lzReceiveSimulate(_origin, _guid, _message, _executor, _extraData);
        }
        /**
         * @dev Internal function to handle the OAppPreCrimeSimulator simulated receive.
         * @param _origin The origin information.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address from the src chain.
         *  - nonce: The nonce of the LayerZero message.
         * @param _guid The GUID of the LayerZero message.
         * @param _message The LayerZero message.
         * @param _executor The address of the off-chain executor.
         * @param _extraData Arbitrary data passed by the msg executor.
         *
         * @dev Enables the preCrime simulator to mock sending lzReceive() messages,
         * routes the msg down from the OAppPreCrimeSimulator, and back up to the OAppReceiver.
         */
        function _lzReceiveSimulate(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address _executor,
            bytes calldata _extraData
        ) internal virtual;
        /**
         * @dev checks if the specified peer is considered 'trusted' by the OApp.
         * @param _eid The endpoint Id to check.
         * @param _peer The peer to check.
         * @return Whether the peer passed is considered 'trusted' by the OApp.
         */
        function isPeer(uint32 _eid, bytes32 _peer) public view virtual returns (bool);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { MessagingReceipt, MessagingFee } from "@layerzerolabs/oapp-evm/contracts/oapp/OAppSender.sol";
    /**
     * @dev Struct representing token parameters for the OFT send() operation.
     */
    struct SendParam {
        uint32 dstEid; // Destination endpoint ID.
        bytes32 to; // Recipient address.
        uint256 amountLD; // Amount to send in local decimals.
        uint256 minAmountLD; // Minimum amount to send in local decimals.
        bytes extraOptions; // Additional options supplied by the caller to be used in the LayerZero message.
        bytes composeMsg; // The composed message for the send() operation.
        bytes oftCmd; // The OFT command to be executed, unused in default OFT implementations.
    }
    /**
     * @dev Struct representing OFT limit information.
     * @dev These amounts can change dynamically and are up the specific oft implementation.
     */
    struct OFTLimit {
        uint256 minAmountLD; // Minimum amount in local decimals that can be sent to the recipient.
        uint256 maxAmountLD; // Maximum amount in local decimals that can be sent to the recipient.
    }
    /**
     * @dev Struct representing OFT receipt information.
     */
    struct OFTReceipt {
        uint256 amountSentLD; // Amount of tokens ACTUALLY debited from the sender in local decimals.
        // @dev In non-default implementations, the amountReceivedLD COULD differ from this value.
        uint256 amountReceivedLD; // Amount of tokens to be received on the remote side.
    }
    /**
     * @dev Struct representing OFT fee details.
     * @dev Future proof mechanism to provide a standardized way to communicate fees to things like a UI.
     */
    struct OFTFeeDetail {
        int256 feeAmountLD; // Amount of the fee in local decimals.
        string description; // Description of the fee.
    }
    /**
     * @title IOFT
     * @dev Interface for the OftChain (OFT) token.
     * @dev Does not inherit ERC20 to accommodate usage by OFTAdapter as well.
     * @dev This specific interface ID is '0x02e49c2c'.
     */
    interface IOFT {
        // Custom error messages
        error InvalidLocalDecimals();
        error SlippageExceeded(uint256 amountLD, uint256 minAmountLD);
        // Events
        event OFTSent(
            bytes32 indexed guid, // GUID of the OFT message.
            uint32 dstEid, // Destination Endpoint ID.
            address indexed fromAddress, // Address of the sender on the src chain.
            uint256 amountSentLD, // Amount of tokens sent in local decimals.
            uint256 amountReceivedLD // Amount of tokens received in local decimals.
        );
        event OFTReceived(
            bytes32 indexed guid, // GUID of the OFT message.
            uint32 srcEid, // Source Endpoint ID.
            address indexed toAddress, // Address of the recipient on the dst chain.
            uint256 amountReceivedLD // Amount of tokens received in local decimals.
        );
        /**
         * @notice Retrieves interfaceID and the version of the OFT.
         * @return interfaceId The interface ID.
         * @return version The version.
         *
         * @dev interfaceId: This specific interface ID is '0x02e49c2c'.
         * @dev version: Indicates a cross-chain compatible msg encoding with other OFTs.
         * @dev If a new feature is added to the OFT cross-chain msg encoding, the version will be incremented.
         * ie. localOFT version(x,1) CAN send messages to remoteOFT version(x,1)
         */
        function oftVersion() external view returns (bytes4 interfaceId, uint64 version);
        /**
         * @notice Retrieves the address of the token associated with the OFT.
         * @return token The address of the ERC20 token implementation.
         */
        function token() external view returns (address);
        /**
         * @notice Indicates whether the OFT contract requires approval of the 'token()' to send.
         * @return requiresApproval Needs approval of the underlying token implementation.
         *
         * @dev Allows things like wallet implementers to determine integration requirements,
         * without understanding the underlying token implementation.
         */
        function approvalRequired() external view returns (bool);
        /**
         * @notice Retrieves the shared decimals of the OFT.
         * @return sharedDecimals The shared decimals of the OFT.
         */
        function sharedDecimals() external view returns (uint8);
        /**
         * @notice Provides the fee breakdown and settings data for an OFT. Unused in the default implementation.
         * @param _sendParam The parameters for the send operation.
         * @return limit The OFT limit information.
         * @return oftFeeDetails The details of OFT fees.
         * @return receipt The OFT receipt information.
         */
        function quoteOFT(
            SendParam calldata _sendParam
        ) external view returns (OFTLimit memory, OFTFeeDetail[] memory oftFeeDetails, OFTReceipt memory);
        /**
         * @notice Provides a quote for the send() operation.
         * @param _sendParam The parameters for the send() operation.
         * @param _payInLzToken Flag indicating whether the caller is paying in the LZ token.
         * @return fee The calculated LayerZero messaging fee from the send() operation.
         *
         * @dev MessagingFee: LayerZero msg fee
         *  - nativeFee: The native fee.
         *  - lzTokenFee: The lzToken fee.
         */
        function quoteSend(SendParam calldata _sendParam, bool _payInLzToken) external view returns (MessagingFee memory);
        /**
         * @notice Executes the send() operation.
         * @param _sendParam The parameters for the send operation.
         * @param _fee The fee information supplied by the caller.
         *      - nativeFee: The native fee.
         *      - lzTokenFee: The lzToken fee.
         * @param _refundAddress The address to receive any excess funds from fees etc. on the src.
         * @return receipt The LayerZero messaging receipt from the send() operation.
         * @return oftReceipt The OFT receipt information.
         *
         * @dev MessagingReceipt: LayerZero msg receipt
         *  - guid: The unique identifier for the sent message.
         *  - nonce: The nonce of the sent message.
         *  - fee: The LayerZero fee incurred for the message.
         */
        function send(
            SendParam calldata _sendParam,
            MessagingFee calldata _fee,
            address _refundAddress
        ) external payable returns (MessagingReceipt memory, OFTReceipt memory);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    library OFTMsgCodec {
        // Offset constants for encoding and decoding OFT messages
        uint8 private constant SEND_TO_OFFSET = 32;
        uint8 private constant SEND_AMOUNT_SD_OFFSET = 40;
        /**
         * @dev Encodes an OFT LayerZero message.
         * @param _sendTo The recipient address.
         * @param _amountShared The amount in shared decimals.
         * @param _composeMsg The composed message.
         * @return _msg The encoded message.
         * @return hasCompose A boolean indicating whether the message has a composed payload.
         */
        function encode(
            bytes32 _sendTo,
            uint64 _amountShared,
            bytes memory _composeMsg
        ) internal view returns (bytes memory _msg, bool hasCompose) {
            hasCompose = _composeMsg.length > 0;
            // @dev Remote chains will want to know the composed function caller ie. msg.sender on the src.
            _msg = hasCompose
                ? abi.encodePacked(_sendTo, _amountShared, addressToBytes32(msg.sender), _composeMsg)
                : abi.encodePacked(_sendTo, _amountShared);
        }
        /**
         * @dev Checks if the OFT message is composed.
         * @param _msg The OFT message.
         * @return A boolean indicating whether the message is composed.
         */
        function isComposed(bytes calldata _msg) internal pure returns (bool) {
            return _msg.length > SEND_AMOUNT_SD_OFFSET;
        }
        /**
         * @dev Retrieves the recipient address from the OFT message.
         * @param _msg The OFT message.
         * @return The recipient address.
         */
        function sendTo(bytes calldata _msg) internal pure returns (bytes32) {
            return bytes32(_msg[:SEND_TO_OFFSET]);
        }
        /**
         * @dev Retrieves the amount in shared decimals from the OFT message.
         * @param _msg The OFT message.
         * @return The amount in shared decimals.
         */
        function amountSD(bytes calldata _msg) internal pure returns (uint64) {
            return uint64(bytes8(_msg[SEND_TO_OFFSET:SEND_AMOUNT_SD_OFFSET]));
        }
        /**
         * @dev Retrieves the composed message from the OFT message.
         * @param _msg The OFT message.
         * @return The composed message.
         */
        function composeMsg(bytes calldata _msg) internal pure returns (bytes memory) {
            return _msg[SEND_AMOUNT_SD_OFFSET:];
        }
        /**
         * @dev Converts an address to bytes32.
         * @param _addr The address to convert.
         * @return The bytes32 representation of the address.
         */
        function addressToBytes32(address _addr) internal pure returns (bytes32) {
            return bytes32(uint256(uint160(_addr)));
        }
        /**
         * @dev Converts bytes32 to an address.
         * @param _b The bytes32 value to convert.
         * @return The address representation of bytes32.
         */
        function bytes32ToAddress(bytes32 _b) internal pure returns (address) {
            return address(uint160(uint256(_b)));
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    library OFTComposeMsgCodec {
        // Offset constants for decoding composed messages
        uint8 private constant NONCE_OFFSET = 8;
        uint8 private constant SRC_EID_OFFSET = 12;
        uint8 private constant AMOUNT_LD_OFFSET = 44;
        uint8 private constant COMPOSE_FROM_OFFSET = 76;
        /**
         * @dev Encodes a OFT composed message.
         * @param _nonce The nonce value.
         * @param _srcEid The source endpoint ID.
         * @param _amountLD The amount in local decimals.
         * @param _composeMsg The composed message.
         * @return _msg The encoded Composed message.
         */
        function encode(
            uint64 _nonce,
            uint32 _srcEid,
            uint256 _amountLD,
            bytes memory _composeMsg // 0x[composeFrom][composeMsg]
        ) internal pure returns (bytes memory _msg) {
            _msg = abi.encodePacked(_nonce, _srcEid, _amountLD, _composeMsg);
        }
        /**
         * @dev Retrieves the nonce for the composed message.
         * @param _msg The message.
         * @return The nonce value.
         */
        function nonce(bytes calldata _msg) internal pure returns (uint64) {
            return uint64(bytes8(_msg[:NONCE_OFFSET]));
        }
        /**
         * @dev Retrieves the source endpoint ID for the composed message.
         * @param _msg The message.
         * @return The source endpoint ID.
         */
        function srcEid(bytes calldata _msg) internal pure returns (uint32) {
            return uint32(bytes4(_msg[NONCE_OFFSET:SRC_EID_OFFSET]));
        }
        /**
         * @dev Retrieves the amount in local decimals from the composed message.
         * @param _msg The message.
         * @return The amount in local decimals.
         */
        function amountLD(bytes calldata _msg) internal pure returns (uint256) {
            return uint256(bytes32(_msg[SRC_EID_OFFSET:AMOUNT_LD_OFFSET]));
        }
        /**
         * @dev Retrieves the composeFrom value from the composed message.
         * @param _msg The message.
         * @return The composeFrom value.
         */
        function composeFrom(bytes calldata _msg) internal pure returns (bytes32) {
            return bytes32(_msg[AMOUNT_LD_OFFSET:COMPOSE_FROM_OFFSET]);
        }
        /**
         * @dev Retrieves the composed message.
         * @param _msg The message.
         * @return The composed message.
         */
        function composeMsg(bytes calldata _msg) internal pure returns (bytes memory) {
            return _msg[COMPOSE_FROM_OFFSET:];
        }
        /**
         * @dev Converts an address to bytes32.
         * @param _addr The address to convert.
         * @return The bytes32 representation of the address.
         */
        function addressToBytes32(address _addr) internal pure returns (bytes32) {
            return bytes32(uint256(uint160(_addr)));
        }
        /**
         * @dev Converts bytes32 to an address.
         * @param _b The bytes32 value to convert.
         * @return The address representation of bytes32.
         */
        function bytes32ToAddress(bytes32 _b) internal pure returns (address) {
            return address(uint160(uint256(_b)));
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { SafeERC20, IERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
    import { MessagingParams, MessagingFee, MessagingReceipt } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ILayerZeroEndpointV2.sol";
    import { OAppCore } from "./OAppCore.sol";
    /**
     * @title OAppSender
     * @dev Abstract contract implementing the OAppSender functionality for sending messages to a LayerZero endpoint.
     */
    abstract contract OAppSender is OAppCore {
        using SafeERC20 for IERC20;
        // Custom error messages
        error NotEnoughNative(uint256 msgValue);
        error LzTokenUnavailable();
        // @dev The version of the OAppSender implementation.
        // @dev Version is bumped when changes are made to this contract.
        uint64 internal constant SENDER_VERSION = 1;
        /**
         * @notice Retrieves the OApp version information.
         * @return senderVersion The version of the OAppSender.sol contract.
         * @return receiverVersion The version of the OAppReceiver.sol contract.
         *
         * @dev Providing 0 as the default for OAppReceiver version. Indicates that the OAppReceiver is not implemented.
         * ie. this is a SEND only OApp.
         * @dev If the OApp uses both OAppSender and OAppReceiver, then this needs to be override returning the correct versions
         */
        function oAppVersion() public view virtual returns (uint64 senderVersion, uint64 receiverVersion) {
            return (SENDER_VERSION, 0);
        }
        /**
         * @dev Internal function to interact with the LayerZero EndpointV2.quote() for fee calculation.
         * @param _dstEid The destination endpoint ID.
         * @param _message The message payload.
         * @param _options Additional options for the message.
         * @param _payInLzToken Flag indicating whether to pay the fee in LZ tokens.
         * @return fee The calculated MessagingFee for the message.
         *      - nativeFee: The native fee for the message.
         *      - lzTokenFee: The LZ token fee for the message.
         */
        function _quote(
            uint32 _dstEid,
            bytes memory _message,
            bytes memory _options,
            bool _payInLzToken
        ) internal view virtual returns (MessagingFee memory fee) {
            return
                endpoint.quote(
                    MessagingParams(_dstEid, _getPeerOrRevert(_dstEid), _message, _options, _payInLzToken),
                    address(this)
                );
        }
        /**
         * @dev Internal function to interact with the LayerZero EndpointV2.send() for sending a message.
         * @param _dstEid The destination endpoint ID.
         * @param _message The message payload.
         * @param _options Additional options for the message.
         * @param _fee The calculated LayerZero fee for the message.
         *      - nativeFee: The native fee.
         *      - lzTokenFee: The lzToken fee.
         * @param _refundAddress The address to receive any excess fee values sent to the endpoint.
         * @return receipt The receipt for the sent message.
         *      - guid: The unique identifier for the sent message.
         *      - nonce: The nonce of the sent message.
         *      - fee: The LayerZero fee incurred for the message.
         */
        function _lzSend(
            uint32 _dstEid,
            bytes memory _message,
            bytes memory _options,
            MessagingFee memory _fee,
            address _refundAddress
        ) internal virtual returns (MessagingReceipt memory receipt) {
            // @dev Push corresponding fees to the endpoint, any excess is sent back to the _refundAddress from the endpoint.
            uint256 messageValue = _payNative(_fee.nativeFee);
            if (_fee.lzTokenFee > 0) _payLzToken(_fee.lzTokenFee);
            return
                // solhint-disable-next-line check-send-result
                endpoint.send{ value: messageValue }(
                    MessagingParams(_dstEid, _getPeerOrRevert(_dstEid), _message, _options, _fee.lzTokenFee > 0),
                    _refundAddress
                );
        }
        /**
         * @dev Internal function to pay the native fee associated with the message.
         * @param _nativeFee The native fee to be paid.
         * @return nativeFee The amount of native currency paid.
         *
         * @dev If the OApp needs to initiate MULTIPLE LayerZero messages in a single transaction,
         * this will need to be overridden because msg.value would contain multiple lzFees.
         * @dev Should be overridden in the event the LayerZero endpoint requires a different native currency.
         * @dev Some EVMs use an ERC20 as a method for paying transactions/gasFees.
         * @dev The endpoint is EITHER/OR, ie. it will NOT support both types of native payment at a time.
         */
        function _payNative(uint256 _nativeFee) internal virtual returns (uint256 nativeFee) {
            if (msg.value != _nativeFee) revert NotEnoughNative(msg.value);
            return _nativeFee;
        }
        /**
         * @dev Internal function to pay the LZ token fee associated with the message.
         * @param _lzTokenFee The LZ token fee to be paid.
         *
         * @dev If the caller is trying to pay in the specified lzToken, then the lzTokenFee is passed to the endpoint.
         * @dev Any excess sent, is passed back to the specified _refundAddress in the _lzSend().
         */
        function _payLzToken(uint256 _lzTokenFee) internal virtual {
            // @dev Cannot cache the token because it is not immutable in the endpoint.
            address lzToken = endpoint.lzToken();
            if (lzToken == address(0)) revert LzTokenUnavailable();
            // Pay LZ token fee by sending tokens to the endpoint.
            IERC20(lzToken).safeTransferFrom(msg.sender, address(endpoint), _lzTokenFee);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { IOAppReceiver, Origin } from "./interfaces/IOAppReceiver.sol";
    import { OAppCore } from "./OAppCore.sol";
    /**
     * @title OAppReceiver
     * @dev Abstract contract implementing the ILayerZeroReceiver interface and extending OAppCore for OApp receivers.
     */
    abstract contract OAppReceiver is IOAppReceiver, OAppCore {
        // Custom error message for when the caller is not the registered endpoint/
        error OnlyEndpoint(address addr);
        // @dev The version of the OAppReceiver implementation.
        // @dev Version is bumped when changes are made to this contract.
        uint64 internal constant RECEIVER_VERSION = 2;
        /**
         * @notice Retrieves the OApp version information.
         * @return senderVersion The version of the OAppSender.sol contract.
         * @return receiverVersion The version of the OAppReceiver.sol contract.
         *
         * @dev Providing 0 as the default for OAppSender version. Indicates that the OAppSender is not implemented.
         * ie. this is a RECEIVE only OApp.
         * @dev If the OApp uses both OAppSender and OAppReceiver, then this needs to be override returning the correct versions.
         */
        function oAppVersion() public view virtual returns (uint64 senderVersion, uint64 receiverVersion) {
            return (0, RECEIVER_VERSION);
        }
        /**
         * @notice Indicates whether an address is an approved composeMsg sender to the Endpoint.
         * @dev _origin The origin information containing the source endpoint and sender address.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address on the src chain.
         *  - nonce: The nonce of the message.
         * @dev _message The lzReceive payload.
         * @param _sender The sender address.
         * @return isSender Is a valid sender.
         *
         * @dev Applications can optionally choose to implement separate composeMsg senders that are NOT the bridging layer.
         * @dev The default sender IS the OAppReceiver implementer.
         */
        function isComposeMsgSender(
            Origin calldata /*_origin*/,
            bytes calldata /*_message*/,
            address _sender
        ) public view virtual returns (bool) {
            return _sender == address(this);
        }
        /**
         * @notice Checks if the path initialization is allowed based on the provided origin.
         * @param origin The origin information containing the source endpoint and sender address.
         * @return Whether the path has been initialized.
         *
         * @dev This indicates to the endpoint that the OApp has enabled msgs for this particular path to be received.
         * @dev This defaults to assuming if a peer has been set, its initialized.
         * Can be overridden by the OApp if there is other logic to determine this.
         */
        function allowInitializePath(Origin calldata origin) public view virtual returns (bool) {
            return peers[origin.srcEid] == origin.sender;
        }
        /**
         * @notice Retrieves the next nonce for a given source endpoint and sender address.
         * @dev _srcEid The source endpoint ID.
         * @dev _sender The sender address.
         * @return nonce The next nonce.
         *
         * @dev The path nonce starts from 1. If 0 is returned it means that there is NO nonce ordered enforcement.
         * @dev Is required by the off-chain executor to determine the OApp expects msg execution is ordered.
         * @dev This is also enforced by the OApp.
         * @dev By default this is NOT enabled. ie. nextNonce is hardcoded to return 0.
         */
        function nextNonce(uint32 /*_srcEid*/, bytes32 /*_sender*/) public view virtual returns (uint64 nonce) {
            return 0;
        }
        /**
         * @dev Entry point for receiving messages or packets from the endpoint.
         * @param _origin The origin information containing the source endpoint and sender address.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address on the src chain.
         *  - nonce: The nonce of the message.
         * @param _guid The unique identifier for the received LayerZero message.
         * @param _message The payload of the received message.
         * @param _executor The address of the executor for the received message.
         * @param _extraData Additional arbitrary data provided by the corresponding executor.
         *
         * @dev Entry point for receiving msg/packet from the LayerZero endpoint.
         */
        function lzReceive(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address _executor,
            bytes calldata _extraData
        ) public payable virtual {
            // Ensures that only the endpoint can attempt to lzReceive() messages to this OApp.
            if (address(endpoint) != msg.sender) revert OnlyEndpoint(msg.sender);
            // Ensure that the sender matches the expected peer for the source endpoint.
            if (_getPeerOrRevert(_origin.srcEid) != _origin.sender) revert OnlyPeer(_origin.srcEid, _origin.sender);
            // Call the internal OApp implementation of lzReceive.
            _lzReceive(_origin, _guid, _message, _executor, _extraData);
        }
        /**
         * @dev Internal function to implement lzReceive logic without needing to copy the basic parameter validation.
         */
        function _lzReceive(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address _executor,
            bytes calldata _extraData
        ) internal virtual;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";
    import { IOAppCore, ILayerZeroEndpointV2 } from "./interfaces/IOAppCore.sol";
    /**
     * @title OAppCore
     * @dev Abstract contract implementing the IOAppCore interface with basic OApp configurations.
     */
    abstract contract OAppCore is IOAppCore, Ownable {
        // The LayerZero endpoint associated with the given OApp
        ILayerZeroEndpointV2 public immutable endpoint;
        // Mapping to store peers associated with corresponding endpoints
        mapping(uint32 eid => bytes32 peer) public peers;
        /**
         * @dev Constructor to initialize the OAppCore with the provided endpoint and delegate.
         * @param _endpoint The address of the LOCAL Layer Zero endpoint.
         * @param _delegate The delegate capable of making OApp configurations inside of the endpoint.
         *
         * @dev The delegate typically should be set as the owner of the contract.
         */
        constructor(address _endpoint, address _delegate) {
            endpoint = ILayerZeroEndpointV2(_endpoint);
            if (_delegate == address(0)) revert InvalidDelegate();
            endpoint.setDelegate(_delegate);
        }
        /**
         * @notice Sets the peer address (OApp instance) for a corresponding endpoint.
         * @param _eid The endpoint ID.
         * @param _peer The address of the peer to be associated with the corresponding endpoint.
         *
         * @dev Only the owner/admin of the OApp can call this function.
         * @dev Indicates that the peer is trusted to send LayerZero messages to this OApp.
         * @dev Set this to bytes32(0) to remove the peer address.
         * @dev Peer is a bytes32 to accommodate non-evm chains.
         */
        function setPeer(uint32 _eid, bytes32 _peer) public virtual onlyOwner {
            _setPeer(_eid, _peer);
        }
        /**
         * @notice Sets the peer address (OApp instance) for a corresponding endpoint.
         * @param _eid The endpoint ID.
         * @param _peer The address of the peer to be associated with the corresponding endpoint.
         *
         * @dev Indicates that the peer is trusted to send LayerZero messages to this OApp.
         * @dev Set this to bytes32(0) to remove the peer address.
         * @dev Peer is a bytes32 to accommodate non-evm chains.
         */
        function _setPeer(uint32 _eid, bytes32 _peer) internal virtual {
            peers[_eid] = _peer;
            emit PeerSet(_eid, _peer);
        }
        /**
         * @notice Internal function to get the peer address associated with a specific endpoint; reverts if NOT set.
         * ie. the peer is set to bytes32(0).
         * @param _eid The endpoint ID.
         * @return peer The address of the peer associated with the specified endpoint.
         */
        function _getPeerOrRevert(uint32 _eid) internal view virtual returns (bytes32) {
            bytes32 peer = peers[_eid];
            if (peer == bytes32(0)) revert NoPeer(_eid);
            return peer;
        }
        /**
         * @notice Sets the delegate address for the OApp.
         * @param _delegate The address of the delegate to be set.
         *
         * @dev Only the owner/admin of the OApp can call this function.
         * @dev Provides the ability for a delegate to set configs, on behalf of the OApp, directly on the Endpoint contract.
         */
        function setDelegate(address _delegate) public onlyOwner {
            endpoint.setDelegate(_delegate);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    /**
     * @dev Struct representing enforced option parameters.
     */
    struct EnforcedOptionParam {
        uint32 eid; // Endpoint ID
        uint16 msgType; // Message Type
        bytes options; // Additional options
    }
    /**
     * @title IOAppOptionsType3
     * @dev Interface for the OApp with Type 3 Options, allowing the setting and combining of enforced options.
     */
    interface IOAppOptionsType3 {
        // Custom error message for invalid options
        error InvalidOptions(bytes options);
        // Event emitted when enforced options are set
        event EnforcedOptionSet(EnforcedOptionParam[] _enforcedOptions);
        /**
         * @notice Sets enforced options for specific endpoint and message type combinations.
         * @param _enforcedOptions An array of EnforcedOptionParam structures specifying enforced options.
         */
        function setEnforcedOptions(EnforcedOptionParam[] calldata _enforcedOptions) external;
        /**
         * @notice Combines options for a given endpoint and message type.
         * @param _eid The endpoint ID.
         * @param _msgType The OApp message type.
         * @param _extraOptions Additional options passed by the caller.
         * @return options The combination of caller specified options AND enforced options.
         */
        function combineOptions(
            uint32 _eid,
            uint16 _msgType,
            bytes calldata _extraOptions
        ) external view returns (bytes memory options);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    struct PreCrimePeer {
        uint32 eid;
        bytes32 preCrime;
        bytes32 oApp;
    }
    // TODO not done yet
    interface IPreCrime {
        error OnlyOffChain();
        // for simulate()
        error PacketOversize(uint256 max, uint256 actual);
        error PacketUnsorted();
        error SimulationFailed(bytes reason);
        // for preCrime()
        error SimulationResultNotFound(uint32 eid);
        error InvalidSimulationResult(uint32 eid, bytes reason);
        error CrimeFound(bytes crime);
        function getConfig(bytes[] calldata _packets, uint256[] calldata _packetMsgValues) external returns (bytes memory);
        function simulate(
            bytes[] calldata _packets,
            uint256[] calldata _packetMsgValues
        ) external payable returns (bytes memory);
        function buildSimulationResult() external view returns (bytes memory);
        function preCrime(
            bytes[] calldata _packets,
            uint256[] calldata _packetMsgValues,
            bytes[] calldata _simulations
        ) external;
        function version() external view returns (uint64 major, uint8 minor);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    // @dev Import the Origin so it's exposed to OAppPreCrimeSimulator implementers.
    // solhint-disable-next-line no-unused-import
    import { InboundPacket, Origin } from "../libs/Packet.sol";
    /**
     * @title IOAppPreCrimeSimulator Interface
     * @dev Interface for the preCrime simulation functionality in an OApp.
     */
    interface IOAppPreCrimeSimulator {
        // @dev simulation result used in PreCrime implementation
        error SimulationResult(bytes result);
        error OnlySelf();
        /**
         * @dev Emitted when the preCrime contract address is set.
         * @param preCrimeAddress The address of the preCrime contract.
         */
        event PreCrimeSet(address preCrimeAddress);
        /**
         * @dev Retrieves the address of the preCrime contract implementation.
         * @return The address of the preCrime contract.
         */
        function preCrime() external view returns (address);
        /**
         * @dev Retrieves the address of the OApp contract.
         * @return The address of the OApp contract.
         */
        function oApp() external view returns (address);
        /**
         * @dev Sets the preCrime contract address.
         * @param _preCrime The address of the preCrime contract.
         */
        function setPreCrime(address _preCrime) external;
        /**
         * @dev Mocks receiving a packet, then reverts with a series of data to infer the state/result.
         * @param _packets An array of LayerZero InboundPacket objects representing received packets.
         */
        function lzReceiveAndRevert(InboundPacket[] calldata _packets) external payable;
        /**
         * @dev checks if the specified peer is considered 'trusted' by the OApp.
         * @param _eid The endpoint Id to check.
         * @param _peer The peer to check.
         * @return Whether the peer passed is considered 'trusted' by the OApp.
         */
        function isPeer(uint32 _eid, bytes32 _peer) external view returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/utils/SafeERC20.sol)
    pragma solidity ^0.8.20;
    import {IERC20} from "../IERC20.sol";
    import {IERC1363} from "../../../interfaces/IERC1363.sol";
    import {Address} from "../../../utils/Address.sol";
    /**
     * @title SafeERC20
     * @dev Wrappers around ERC-20 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 {
        /**
         * @dev An operation with an ERC-20 token failed.
         */
        error SafeERC20FailedOperation(address token);
        /**
         * @dev Indicates a failed `decreaseAllowance` request.
         */
        error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);
        /**
         * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
         * non-reverting calls are assumed to be successful.
         */
        function safeTransfer(IERC20 token, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeCall(token.transfer, (to, value)));
        }
        /**
         * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
         * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
         */
        function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeCall(token.transferFrom, (from, to, value)));
        }
        /**
         * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
         * non-reverting calls are assumed to be successful.
         *
         * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the "client"
         * smart contract uses ERC-7674 to set temporary allowances, then the "client" smart contract should avoid using
         * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract
         * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.
         */
        function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 oldAllowance = token.allowance(address(this), spender);
            forceApprove(token, spender, oldAllowance + value);
        }
        /**
         * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no
         * value, non-reverting calls are assumed to be successful.
         *
         * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the "client"
         * smart contract uses ERC-7674 to set temporary allowances, then the "client" smart contract should avoid using
         * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract
         * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.
         */
        function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {
            unchecked {
                uint256 currentAllowance = token.allowance(address(this), spender);
                if (currentAllowance < requestedDecrease) {
                    revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);
                }
                forceApprove(token, spender, currentAllowance - requestedDecrease);
            }
        }
        /**
         * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
         * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval
         * to be set to zero before setting it to a non-zero value, such as USDT.
         *
         * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function
         * only sets the "standard" allowance. Any temporary allowance will remain active, in addition to the value being
         * set here.
         */
        function forceApprove(IERC20 token, address spender, uint256 value) internal {
            bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));
            if (!_callOptionalReturnBool(token, approvalCall)) {
                _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));
                _callOptionalReturn(token, approvalCall);
            }
        }
        /**
         * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no
         * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
         * targeting contracts.
         *
         * Reverts if the returned value is other than `true`.
         */
        function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {
            if (to.code.length == 0) {
                safeTransfer(token, to, value);
            } else if (!token.transferAndCall(to, value, data)) {
                revert SafeERC20FailedOperation(address(token));
            }
        }
        /**
         * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target
         * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
         * targeting contracts.
         *
         * Reverts if the returned value is other than `true`.
         */
        function transferFromAndCallRelaxed(
            IERC1363 token,
            address from,
            address to,
            uint256 value,
            bytes memory data
        ) internal {
            if (to.code.length == 0) {
                safeTransferFrom(token, from, to, value);
            } else if (!token.transferFromAndCall(from, to, value, data)) {
                revert SafeERC20FailedOperation(address(token));
            }
        }
        /**
         * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no
         * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
         * targeting contracts.
         *
         * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.
         * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}
         * once without retrying, and relies on the returned value to be true.
         *
         * Reverts if the returned value is other than `true`.
         */
        function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {
            if (to.code.length == 0) {
                forceApprove(token, to, value);
            } else if (!token.approveAndCall(to, value, data)) {
                revert SafeERC20FailedOperation(address(token));
            }
        }
        /**
         * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
         * on the return value: the return value is optional (but if data is returned, it must not be false).
         * @param token The token targeted by the call.
         * @param data The call data (encoded using abi.encode or one of its variants).
         *
         * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.
         */
        function _callOptionalReturn(IERC20 token, bytes memory data) private {
            uint256 returnSize;
            uint256 returnValue;
            assembly ("memory-safe") {
                let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
                // bubble errors
                if iszero(success) {
                    let ptr := mload(0x40)
                    returndatacopy(ptr, 0, returndatasize())
                    revert(ptr, returndatasize())
                }
                returnSize := returndatasize()
                returnValue := mload(0)
            }
            if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {
                revert SafeERC20FailedOperation(address(token));
            }
        }
        /**
         * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
         * on the return value: the return value is optional (but if data is returned, it must not be false).
         * @param token The token targeted by the call.
         * @param data The call data (encoded using abi.encode or one of its variants).
         *
         * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.
         */
        function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
            bool success;
            uint256 returnSize;
            uint256 returnValue;
            assembly ("memory-safe") {
                success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
                returnSize := returndatasize()
                returnValue := mload(0)
            }
            return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    import { IMessageLibManager } from "./IMessageLibManager.sol";
    import { IMessagingComposer } from "./IMessagingComposer.sol";
    import { IMessagingChannel } from "./IMessagingChannel.sol";
    import { IMessagingContext } from "./IMessagingContext.sol";
    struct MessagingParams {
        uint32 dstEid;
        bytes32 receiver;
        bytes message;
        bytes options;
        bool payInLzToken;
    }
    struct MessagingReceipt {
        bytes32 guid;
        uint64 nonce;
        MessagingFee fee;
    }
    struct MessagingFee {
        uint256 nativeFee;
        uint256 lzTokenFee;
    }
    struct Origin {
        uint32 srcEid;
        bytes32 sender;
        uint64 nonce;
    }
    interface ILayerZeroEndpointV2 is IMessageLibManager, IMessagingComposer, IMessagingChannel, IMessagingContext {
        event PacketSent(bytes encodedPayload, bytes options, address sendLibrary);
        event PacketVerified(Origin origin, address receiver, bytes32 payloadHash);
        event PacketDelivered(Origin origin, address receiver);
        event LzReceiveAlert(
            address indexed receiver,
            address indexed executor,
            Origin origin,
            bytes32 guid,
            uint256 gas,
            uint256 value,
            bytes message,
            bytes extraData,
            bytes reason
        );
        event LzTokenSet(address token);
        event DelegateSet(address sender, address delegate);
        function quote(MessagingParams calldata _params, address _sender) external view returns (MessagingFee memory);
        function send(
            MessagingParams calldata _params,
            address _refundAddress
        ) external payable returns (MessagingReceipt memory);
        function verify(Origin calldata _origin, address _receiver, bytes32 _payloadHash) external;
        function verifiable(Origin calldata _origin, address _receiver) external view returns (bool);
        function initializable(Origin calldata _origin, address _receiver) external view returns (bool);
        function lzReceive(
            Origin calldata _origin,
            address _receiver,
            bytes32 _guid,
            bytes calldata _message,
            bytes calldata _extraData
        ) external payable;
        // oapp can burn messages partially by calling this function with its own business logic if messages are verified in order
        function clear(address _oapp, Origin calldata _origin, bytes32 _guid, bytes calldata _message) external;
        function setLzToken(address _lzToken) external;
        function lzToken() external view returns (address);
        function nativeToken() external view returns (address);
        function setDelegate(address _delegate) external;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { ILayerZeroReceiver, Origin } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ILayerZeroReceiver.sol";
    interface IOAppReceiver is ILayerZeroReceiver {
        /**
         * @notice Indicates whether an address is an approved composeMsg sender to the Endpoint.
         * @param _origin The origin information containing the source endpoint and sender address.
         *  - srcEid: The source chain endpoint ID.
         *  - sender: The sender address on the src chain.
         *  - nonce: The nonce of the message.
         * @param _message The lzReceive payload.
         * @param _sender The sender address.
         * @return isSender Is a valid sender.
         *
         * @dev Applications can optionally choose to implement a separate composeMsg sender that is NOT the bridging layer.
         * @dev The default sender IS the OAppReceiver implementer.
         */
        function isComposeMsgSender(
            Origin calldata _origin,
            bytes calldata _message,
            address _sender
        ) external view returns (bool isSender);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { ILayerZeroEndpointV2 } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ILayerZeroEndpointV2.sol";
    /**
     * @title IOAppCore
     */
    interface IOAppCore {
        // Custom error messages
        error OnlyPeer(uint32 eid, bytes32 sender);
        error NoPeer(uint32 eid);
        error InvalidEndpointCall();
        error InvalidDelegate();
        // Event emitted when a peer (OApp) is set for a corresponding endpoint
        event PeerSet(uint32 eid, bytes32 peer);
        /**
         * @notice Retrieves the OApp version information.
         * @return senderVersion The version of the OAppSender.sol contract.
         * @return receiverVersion The version of the OAppReceiver.sol contract.
         */
        function oAppVersion() external view returns (uint64 senderVersion, uint64 receiverVersion);
        /**
         * @notice Retrieves the LayerZero endpoint associated with the OApp.
         * @return iEndpoint The LayerZero endpoint as an interface.
         */
        function endpoint() external view returns (ILayerZeroEndpointV2 iEndpoint);
        /**
         * @notice Retrieves the peer (OApp) associated with a corresponding endpoint.
         * @param _eid The endpoint ID.
         * @return peer The peer address (OApp instance) associated with the corresponding endpoint.
         */
        function peers(uint32 _eid) external view returns (bytes32 peer);
        /**
         * @notice Sets the peer address (OApp instance) for a corresponding endpoint.
         * @param _eid The endpoint ID.
         * @param _peer The address of the peer to be associated with the corresponding endpoint.
         */
        function setPeer(uint32 _eid, bytes32 _peer) external;
        /**
         * @notice Sets the delegate address for the OApp Core.
         * @param _delegate The address of the delegate to be set.
         */
        function setDelegate(address _delegate) external;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.20;
    import { Origin } from "@layerzerolabs/lz-evm-protocol-v2/contracts/interfaces/ILayerZeroEndpointV2.sol";
    import { PacketV1Codec } from "@layerzerolabs/lz-evm-protocol-v2/contracts/messagelib/libs/PacketV1Codec.sol";
    /**
     * @title InboundPacket
     * @dev Structure representing an inbound packet received by the contract.
     */
    struct InboundPacket {
        Origin origin; // Origin information of the packet.
        uint32 dstEid; // Destination endpointId of the packet.
        address receiver; // Receiver address for the packet.
        bytes32 guid; // Unique identifier of the packet.
        uint256 value; // msg.value of the packet.
        address executor; // Executor address for the packet.
        bytes message; // Message payload of the packet.
        bytes extraData; // Additional arbitrary data for the packet.
    }
    /**
     * @title PacketDecoder
     * @dev Library for decoding LayerZero packets.
     */
    library PacketDecoder {
        using PacketV1Codec for bytes;
        /**
         * @dev Decode an inbound packet from the given packet data.
         * @param _packet The packet data to decode.
         * @return packet An InboundPacket struct representing the decoded packet.
         */
        function decode(bytes calldata _packet) internal pure returns (InboundPacket memory packet) {
            packet.origin = Origin(_packet.srcEid(), _packet.sender(), _packet.nonce());
            packet.dstEid = _packet.dstEid();
            packet.receiver = _packet.receiverB20();
            packet.guid = _packet.guid();
            packet.message = _packet.message();
        }
        /**
         * @dev Decode multiple inbound packets from the given packet data and associated message values.
         * @param _packets An array of packet data to decode.
         * @param _packetMsgValues An array of associated message values for each packet.
         * @return packets An array of InboundPacket structs representing the decoded packets.
         */
        function decode(
            bytes[] calldata _packets,
            uint256[] memory _packetMsgValues
        ) internal pure returns (InboundPacket[] memory packets) {
            packets = new InboundPacket[](_packets.length);
            for (uint256 i = 0; i < _packets.length; i++) {
                bytes calldata packet = _packets[i];
                packets[i] = PacketDecoder.decode(packet);
                // @dev Allows the verifier to specify the msg.value that gets passed in lzReceive.
                packets[i].value = _packetMsgValues[i];
            }
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1363.sol)
    pragma solidity ^0.8.20;
    import {IERC20} from "./IERC20.sol";
    import {IERC165} from "./IERC165.sol";
    /**
     * @title IERC1363
     * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].
     *
     * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract
     * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.
     */
    interface IERC1363 is IERC20, IERC165 {
        /*
         * Note: the ERC-165 identifier for this interface is 0xb0202a11.
         * 0xb0202a11 ===
         *   bytes4(keccak256('transferAndCall(address,uint256)')) ^
         *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^
         *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^
         *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^
         *   bytes4(keccak256('approveAndCall(address,uint256)')) ^
         *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))
         */
        /**
         * @dev Moves a `value` amount of tokens from the caller's account to `to`
         * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
         * @param to The address which you want to transfer to.
         * @param value The amount of tokens to be transferred.
         * @return A boolean value indicating whether the operation succeeded unless throwing.
         */
        function transferAndCall(address to, uint256 value) external returns (bool);
        /**
         * @dev Moves a `value` amount of tokens from the caller's account to `to`
         * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
         * @param to The address which you want to transfer to.
         * @param value The amount of tokens to be transferred.
         * @param data Additional data with no specified format, sent in call to `to`.
         * @return A boolean value indicating whether the operation succeeded unless throwing.
         */
        function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);
        /**
         * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism
         * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
         * @param from The address which you want to send tokens from.
         * @param to The address which you want to transfer to.
         * @param value The amount of tokens to be transferred.
         * @return A boolean value indicating whether the operation succeeded unless throwing.
         */
        function transferFromAndCall(address from, address to, uint256 value) external returns (bool);
        /**
         * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism
         * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
         * @param from The address which you want to send tokens from.
         * @param to The address which you want to transfer to.
         * @param value The amount of tokens to be transferred.
         * @param data Additional data with no specified format, sent in call to `to`.
         * @return A boolean value indicating whether the operation succeeded unless throwing.
         */
        function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);
        /**
         * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
         * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.
         * @param spender The address which will spend the funds.
         * @param value The amount of tokens to be spent.
         * @return A boolean value indicating whether the operation succeeded unless throwing.
         */
        function approveAndCall(address spender, uint256 value) external returns (bool);
        /**
         * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
         * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.
         * @param spender The address which will spend the funds.
         * @param value The amount of tokens to be spent.
         * @param data Additional data with no specified format, sent in call to `spender`.
         * @return A boolean value indicating whether the operation succeeded unless throwing.
         */
        function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (utils/Address.sol)
    pragma solidity ^0.8.20;
    import {Errors} from "./Errors.sol";
    /**
     * @dev Collection of functions related to the address type
     */
    library Address {
        /**
         * @dev There's no code at `target` (it is not a contract).
         */
        error AddressEmptyCode(address target);
        /**
         * @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.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            if (address(this).balance < amount) {
                revert Errors.InsufficientBalance(address(this).balance, amount);
            }
            (bool success, ) = recipient.call{value: amount}("");
            if (!success) {
                revert Errors.FailedCall();
            }
        }
        /**
         * @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 or custom error, it is bubbled
         * up by this function (like regular Solidity function calls). However, if
         * the call reverted with no returned reason, this function reverts with a
         * {Errors.FailedCall} error.
         *
         * 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.
         */
        function functionCall(address target, bytes memory data) internal returns (bytes memory) {
            return functionCallWithValue(target, data, 0);
        }
        /**
         * @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`.
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
            if (address(this).balance < value) {
                revert Errors.InsufficientBalance(address(this).balance, value);
            }
            (bool success, bytes memory returndata) = target.call{value: value}(data);
            return verifyCallResultFromTarget(target, success, returndata);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a static call.
         */
        function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
            (bool success, bytes memory returndata) = target.staticcall(data);
            return verifyCallResultFromTarget(target, success, returndata);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a delegate call.
         */
        function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
            (bool success, bytes memory returndata) = target.delegatecall(data);
            return verifyCallResultFromTarget(target, success, returndata);
        }
        /**
         * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
         * was not a contract or bubbling up the revert reason (falling back to {Errors.FailedCall}) in case
         * of an unsuccessful call.
         */
        function verifyCallResultFromTarget(
            address target,
            bool success,
            bytes memory returndata
        ) internal view returns (bytes memory) {
            if (!success) {
                _revert(returndata);
            } else {
                // only check if target is a contract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                if (returndata.length == 0 && target.code.length == 0) {
                    revert AddressEmptyCode(target);
                }
                return returndata;
            }
        }
        /**
         * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
         * revert reason or with a default {Errors.FailedCall} error.
         */
        function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
            if (!success) {
                _revert(returndata);
            } else {
                return returndata;
            }
        }
        /**
         * @dev Reverts with returndata if present. Otherwise reverts with {Errors.FailedCall}.
         */
        function _revert(bytes memory returndata) 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
                assembly ("memory-safe") {
                    let returndata_size := mload(returndata)
                    revert(add(32, returndata), returndata_size)
                }
            } else {
                revert Errors.FailedCall();
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    struct SetConfigParam {
        uint32 eid;
        uint32 configType;
        bytes config;
    }
    interface IMessageLibManager {
        struct Timeout {
            address lib;
            uint256 expiry;
        }
        event LibraryRegistered(address newLib);
        event DefaultSendLibrarySet(uint32 eid, address newLib);
        event DefaultReceiveLibrarySet(uint32 eid, address newLib);
        event DefaultReceiveLibraryTimeoutSet(uint32 eid, address oldLib, uint256 expiry);
        event SendLibrarySet(address sender, uint32 eid, address newLib);
        event ReceiveLibrarySet(address receiver, uint32 eid, address newLib);
        event ReceiveLibraryTimeoutSet(address receiver, uint32 eid, address oldLib, uint256 timeout);
        function registerLibrary(address _lib) external;
        function isRegisteredLibrary(address _lib) external view returns (bool);
        function getRegisteredLibraries() external view returns (address[] memory);
        function setDefaultSendLibrary(uint32 _eid, address _newLib) external;
        function defaultSendLibrary(uint32 _eid) external view returns (address);
        function setDefaultReceiveLibrary(uint32 _eid, address _newLib, uint256 _gracePeriod) external;
        function defaultReceiveLibrary(uint32 _eid) external view returns (address);
        function setDefaultReceiveLibraryTimeout(uint32 _eid, address _lib, uint256 _expiry) external;
        function defaultReceiveLibraryTimeout(uint32 _eid) external view returns (address lib, uint256 expiry);
        function isSupportedEid(uint32 _eid) external view returns (bool);
        function isValidReceiveLibrary(address _receiver, uint32 _eid, address _lib) external view returns (bool);
        /// ------------------- OApp interfaces -------------------
        function setSendLibrary(address _oapp, uint32 _eid, address _newLib) external;
        function getSendLibrary(address _sender, uint32 _eid) external view returns (address lib);
        function isDefaultSendLibrary(address _sender, uint32 _eid) external view returns (bool);
        function setReceiveLibrary(address _oapp, uint32 _eid, address _newLib, uint256 _gracePeriod) external;
        function getReceiveLibrary(address _receiver, uint32 _eid) external view returns (address lib, bool isDefault);
        function setReceiveLibraryTimeout(address _oapp, uint32 _eid, address _lib, uint256 _expiry) external;
        function receiveLibraryTimeout(address _receiver, uint32 _eid) external view returns (address lib, uint256 expiry);
        function setConfig(address _oapp, address _lib, SetConfigParam[] calldata _params) external;
        function getConfig(
            address _oapp,
            address _lib,
            uint32 _eid,
            uint32 _configType
        ) external view returns (bytes memory config);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    interface IMessagingComposer {
        event ComposeSent(address from, address to, bytes32 guid, uint16 index, bytes message);
        event ComposeDelivered(address from, address to, bytes32 guid, uint16 index);
        event LzComposeAlert(
            address indexed from,
            address indexed to,
            address indexed executor,
            bytes32 guid,
            uint16 index,
            uint256 gas,
            uint256 value,
            bytes message,
            bytes extraData,
            bytes reason
        );
        function composeQueue(
            address _from,
            address _to,
            bytes32 _guid,
            uint16 _index
        ) external view returns (bytes32 messageHash);
        function sendCompose(address _to, bytes32 _guid, uint16 _index, bytes calldata _message) external;
        function lzCompose(
            address _from,
            address _to,
            bytes32 _guid,
            uint16 _index,
            bytes calldata _message,
            bytes calldata _extraData
        ) external payable;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    interface IMessagingChannel {
        event InboundNonceSkipped(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce);
        event PacketNilified(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce, bytes32 payloadHash);
        event PacketBurnt(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce, bytes32 payloadHash);
        function eid() external view returns (uint32);
        // this is an emergency function if a message cannot be verified for some reasons
        // required to provide _nextNonce to avoid race condition
        function skip(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce) external;
        function nilify(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce, bytes32 _payloadHash) external;
        function burn(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce, bytes32 _payloadHash) external;
        function nextGuid(address _sender, uint32 _dstEid, bytes32 _receiver) external view returns (bytes32);
        function inboundNonce(address _receiver, uint32 _srcEid, bytes32 _sender) external view returns (uint64);
        function outboundNonce(address _sender, uint32 _dstEid, bytes32 _receiver) external view returns (uint64);
        function inboundPayloadHash(
            address _receiver,
            uint32 _srcEid,
            bytes32 _sender,
            uint64 _nonce
        ) external view returns (bytes32);
        function lazyInboundNonce(address _receiver, uint32 _srcEid, bytes32 _sender) external view returns (uint64);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    interface IMessagingContext {
        function isSendingMessage() external view returns (bool);
        function getSendContext() external view returns (uint32 dstEid, address sender);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    import { Origin } from "./ILayerZeroEndpointV2.sol";
    interface ILayerZeroReceiver {
        function allowInitializePath(Origin calldata _origin) external view returns (bool);
        function nextNonce(uint32 _eid, bytes32 _sender) external view returns (uint64);
        function lzReceive(
            Origin calldata _origin,
            bytes32 _guid,
            bytes calldata _message,
            address _executor,
            bytes calldata _extraData
        ) external payable;
    }
    // SPDX-License-Identifier: LZBL-1.2
    pragma solidity ^0.8.20;
    import { Packet } from "../../interfaces/ISendLib.sol";
    import { AddressCast } from "../../libs/AddressCast.sol";
    library PacketV1Codec {
        using AddressCast for address;
        using AddressCast for bytes32;
        uint8 internal constant PACKET_VERSION = 1;
        // header (version + nonce + path)
        // version
        uint256 private constant PACKET_VERSION_OFFSET = 0;
        //    nonce
        uint256 private constant NONCE_OFFSET = 1;
        //    path
        uint256 private constant SRC_EID_OFFSET = 9;
        uint256 private constant SENDER_OFFSET = 13;
        uint256 private constant DST_EID_OFFSET = 45;
        uint256 private constant RECEIVER_OFFSET = 49;
        // payload (guid + message)
        uint256 private constant GUID_OFFSET = 81; // keccak256(nonce + path)
        uint256 private constant MESSAGE_OFFSET = 113;
        function encode(Packet memory _packet) internal pure returns (bytes memory encodedPacket) {
            encodedPacket = abi.encodePacked(
                PACKET_VERSION,
                _packet.nonce,
                _packet.srcEid,
                _packet.sender.toBytes32(),
                _packet.dstEid,
                _packet.receiver,
                _packet.guid,
                _packet.message
            );
        }
        function encodePacketHeader(Packet memory _packet) internal pure returns (bytes memory) {
            return
                abi.encodePacked(
                    PACKET_VERSION,
                    _packet.nonce,
                    _packet.srcEid,
                    _packet.sender.toBytes32(),
                    _packet.dstEid,
                    _packet.receiver
                );
        }
        function encodePayload(Packet memory _packet) internal pure returns (bytes memory) {
            return abi.encodePacked(_packet.guid, _packet.message);
        }
        function header(bytes calldata _packet) internal pure returns (bytes calldata) {
            return _packet[0:GUID_OFFSET];
        }
        function version(bytes calldata _packet) internal pure returns (uint8) {
            return uint8(bytes1(_packet[PACKET_VERSION_OFFSET:NONCE_OFFSET]));
        }
        function nonce(bytes calldata _packet) internal pure returns (uint64) {
            return uint64(bytes8(_packet[NONCE_OFFSET:SRC_EID_OFFSET]));
        }
        function srcEid(bytes calldata _packet) internal pure returns (uint32) {
            return uint32(bytes4(_packet[SRC_EID_OFFSET:SENDER_OFFSET]));
        }
        function sender(bytes calldata _packet) internal pure returns (bytes32) {
            return bytes32(_packet[SENDER_OFFSET:DST_EID_OFFSET]);
        }
        function senderAddressB20(bytes calldata _packet) internal pure returns (address) {
            return sender(_packet).toAddress();
        }
        function dstEid(bytes calldata _packet) internal pure returns (uint32) {
            return uint32(bytes4(_packet[DST_EID_OFFSET:RECEIVER_OFFSET]));
        }
        function receiver(bytes calldata _packet) internal pure returns (bytes32) {
            return bytes32(_packet[RECEIVER_OFFSET:GUID_OFFSET]);
        }
        function receiverB20(bytes calldata _packet) internal pure returns (address) {
            return receiver(_packet).toAddress();
        }
        function guid(bytes calldata _packet) internal pure returns (bytes32) {
            return bytes32(_packet[GUID_OFFSET:MESSAGE_OFFSET]);
        }
        function message(bytes calldata _packet) internal pure returns (bytes calldata) {
            return bytes(_packet[MESSAGE_OFFSET:]);
        }
        function payload(bytes calldata _packet) internal pure returns (bytes calldata) {
            return bytes(_packet[GUID_OFFSET:]);
        }
        function payloadHash(bytes calldata _packet) internal pure returns (bytes32) {
            return keccak256(payload(_packet));
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC20.sol)
    pragma solidity ^0.8.20;
    import {IERC20} from "../token/ERC20/IERC20.sol";
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)
    pragma solidity ^0.8.20;
    import {IERC165} from "../utils/introspection/IERC165.sol";
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (utils/Errors.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Collection of common custom errors used in multiple contracts
     *
     * IMPORTANT: Backwards compatibility is not guaranteed in future versions of the library.
     * It is recommended to avoid relying on the error API for critical functionality.
     *
     * _Available since v5.1._
     */
    library Errors {
        /**
         * @dev The ETH balance of the account is not enough to perform the operation.
         */
        error InsufficientBalance(uint256 balance, uint256 needed);
        /**
         * @dev A call to an address target failed. The target may have reverted.
         */
        error FailedCall();
        /**
         * @dev The deployment failed.
         */
        error FailedDeployment();
        /**
         * @dev A necessary precompile is missing.
         */
        error MissingPrecompile(address);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.8.0;
    import { MessagingFee } from "./ILayerZeroEndpointV2.sol";
    import { IMessageLib } from "./IMessageLib.sol";
    struct Packet {
        uint64 nonce;
        uint32 srcEid;
        address sender;
        uint32 dstEid;
        bytes32 receiver;
        bytes32 guid;
        bytes message;
    }
    interface ISendLib is IMessageLib {
        function send(
            Packet calldata _packet,
            bytes calldata _options,
            bool _payInLzToken
        ) external returns (MessagingFee memory, bytes memory encodedPacket);
        function quote(
            Packet calldata _packet,
            bytes calldata _options,
            bool _payInLzToken
        ) external view returns (MessagingFee memory);
        function setTreasury(address _treasury) external;
        function withdrawFee(address _to, uint256 _amount) external;
        function withdrawLzTokenFee(address _lzToken, address _to, uint256 _amount) external;
    }
    // SPDX-License-Identifier: LZBL-1.2
    pragma solidity ^0.8.20;
    library AddressCast {
        error AddressCast_InvalidSizeForAddress();
        error AddressCast_InvalidAddress();
        function toBytes32(bytes calldata _addressBytes) internal pure returns (bytes32 result) {
            if (_addressBytes.length > 32) revert AddressCast_InvalidAddress();
            result = bytes32(_addressBytes);
            unchecked {
                uint256 offset = 32 - _addressBytes.length;
                result = result >> (offset * 8);
            }
        }
        function toBytes32(address _address) internal pure returns (bytes32 result) {
            result = bytes32(uint256(uint160(_address)));
        }
        function toBytes(bytes32 _addressBytes32, uint256 _size) internal pure returns (bytes memory result) {
            if (_size == 0 || _size > 32) revert AddressCast_InvalidSizeForAddress();
            result = new bytes(_size);
            unchecked {
                uint256 offset = 256 - _size * 8;
                assembly {
                    mstore(add(result, 32), shl(offset, _addressBytes32))
                }
            }
        }
        function toAddress(bytes32 _addressBytes32) internal pure returns (address result) {
            result = address(uint160(uint256(_addressBytes32)));
        }
        function toAddress(bytes calldata _addressBytes) internal pure returns (address result) {
            if (_addressBytes.length != 20) revert AddressCast_InvalidAddress();
            result = address(bytes20(_addressBytes));
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)
    pragma solidity ^0.8.20;
    /**
     * @dev Interface of the ERC-165 standard, as defined in the
     * https://eips.ethereum.org/EIPS/eip-165[ERC].
     *
     * 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[ERC 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
    pragma solidity >=0.8.0;
    import { IERC165 } from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
    import { SetConfigParam } from "./IMessageLibManager.sol";
    enum MessageLibType {
        Send,
        Receive,
        SendAndReceive
    }
    interface IMessageLib is IERC165 {
        function setConfig(address _oapp, SetConfigParam[] calldata _config) external;
        function getConfig(uint32 _eid, address _oapp, uint32 _configType) external view returns (bytes memory config);
        function isSupportedEid(uint32 _eid) external view returns (bool);
        // message libs of same major version are compatible
        function version() external view returns (uint64 major, uint8 minor, uint8 endpointVersion);
        function messageLibType() external view returns (MessageLibType);
    }