ETH Price: $3,528.55 (-5.46%)

Transaction Decoder

Block:
23455144 at Sep-27-2025 03:10:23 PM +UTC
Transaction Fee:
0.000061141551497838 ETH $0.22
Gas Used:
101,626 Gas / 0.601632963 Gwei

Emitted Events:

507 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x00000000000000000000000038e4254bd82ed5ee97cd1c4278faae748d998865, 0x0000000000000000000000007dae06dc581668b42da512f59675e3db2ae7498f, 000000000000000000000000000000000000000000000000b040ef504664a722 )
508 StakingRewards.RewardPaid( user=0x7dae06dc581668b42da512f59675e3db2ae7498f, reward=12700414077242222370 )
509 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000007dae06dc581668b42da512f59675e3db2ae7498f, 0x000000000000000000000000cbbfe70990aee7da0ea89446c1db15ca2a3681da, 000000000000000000000000000000000000000000000000b040ef504664a722 )
510 LockstakeEngine.GetReward( owner=[Sender] 0xcbbfe70990aee7da0ea89446c1db15ca2a3681da, index=0, farm=StakingRewards, to=[Sender] 0xcbbfe70990aee7da0ea89446c1db15ca2a3681da, amt=12700414077242222370 )

Account State Difference:

  Address   Before After State Difference Code
0x38E4254b...48d998865
(Titan Builder)
1.409437903791911509 Eth1.409438005417911509 Eth0.000000101626
0xcbbFE709...a2a3681da
0.003190274609554842 Eth
Nonce: 183
0.003129133058057004 Eth
Nonce: 184
0.000061141551497838
0xdC035D45...1e407384F

Execution Trace

LockstakeEngine.getReward( owner=0xcbbFE70990AEe7DA0eA89446C1dB15ca2a3681da, index=0, farm=0x38E4254bD82ED5Ee97CD1C4278FAae748d998865, to=0xcbbFE70990AEe7DA0eA89446C1dB15ca2a3681da ) => ( amt=12700414077242222370 )
  • 0x7dae06dc581668b42da512f59675e3db2ae7498f.6b091695( )
    • LockstakeUrn.getReward( farm=0x38E4254bD82ED5Ee97CD1C4278FAae748d998865, to=0xcbbFE70990AEe7DA0eA89446C1dB15ca2a3681da ) => ( amt=12700414077242222370 )
      • StakingRewards.CALL( )
        • ERC1967Proxy.a9059cbb( )
          • Usds.transfer( to=0x7dAE06dc581668B42Da512f59675E3dB2Ae7498F, value=12700414077242222370 ) => ( True )
          • StakingRewards.STATICCALL( )
          • ERC1967Proxy.70a08231( )
            • Usds.balanceOf( 0x7dAE06dc581668B42Da512f59675E3dB2Ae7498F ) => ( 12700414077242222370 )
            • ERC1967Proxy.a9059cbb( )
              • Usds.transfer( to=0xcbbFE70990AEe7DA0eA89446C1dB15ca2a3681da, value=12700414077242222370 ) => ( True )
                File 1 of 5: LockstakeEngine
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.21;
                import { LockstakeUrn } from "src/LockstakeUrn.sol";
                import { Multicall } from "src/Multicall.sol";
                interface VoteDelegateFactoryLike {
                    function created(address) external returns (uint256);
                }
                interface VoteDelegateLike {
                    function lock(uint256) external;
                    function free(uint256) external;
                }
                interface VatLike {
                    function ilks(bytes32) external view returns (uint256, uint256, uint256, uint256, uint256);
                    function urns(bytes32, address) external view returns (uint256, uint256);
                    function hope(address) external;
                    function slip(bytes32, address, int256) external;
                    function frob(bytes32, address, address, address, int256, int256) external;
                    function grab(bytes32, address, address, address, int256, int256) external;
                }
                interface UsdsJoinLike {
                    function vat() external view returns (VatLike);
                    function usds() external view returns (GemLike);
                    function join(address, uint256) external;
                    function exit(address, uint256) external;
                }
                interface GemLike {
                    function approve(address, uint256) external;
                    function transfer(address, uint256) external;
                    function transferFrom(address, address, uint256) external;
                    function mint(address, uint256) external;
                    function burn(address, uint256) external;
                }
                interface JugLike {
                    function drip(bytes32) external returns (uint256);
                }
                contract LockstakeEngine is Multicall {
                    // --- storage variables ---
                    mapping(address usr   => uint256 allowed)                         public wards;
                    mapping(address farm  => FarmStatus)                              public farms;
                    mapping(address owner => uint256 count)                           public ownerUrnsCount;
                    mapping(address owner => mapping(uint256 index => address urn))   public ownerUrns;
                    mapping(address urn   => address owner)                           public urnOwners;
                    mapping(address urn   => mapping(address usr => uint256 allowed)) public urnCan;
                    mapping(address urn   => address voteDelegate)                    public urnVoteDelegates;
                    mapping(address urn   => address farm)                            public urnFarms;
                    mapping(address urn   => uint256 auctionsCount)                   public urnAuctions;
                    JugLike                                                           public jug;
                    // --- constants and enums ---
                    uint256 constant WAD = 10**18;
                    uint256 constant RAY = 10**27;
                    enum FarmStatus { UNSUPPORTED, ACTIVE, DELETED }
                    // --- immutables ---
                    VoteDelegateFactoryLike immutable public voteDelegateFactory;
                    VatLike                 immutable public vat;
                    UsdsJoinLike            immutable public usdsJoin;
                    GemLike                 immutable public usds;
                    bytes32                 immutable public ilk;
                    GemLike                 immutable public sky;
                    GemLike                 immutable public lssky;
                    address                 immutable public urnImplementation;
                    uint256                 immutable public fee;
                    // --- events ---   
                    event Rely(address indexed usr);
                    event Deny(address indexed usr);
                    event File(bytes32 indexed what, address data);
                    event AddFarm(address farm);
                    event DelFarm(address farm);
                    event Open(address indexed owner, uint256 indexed index, address urn);
                    event Hope(address indexed owner, uint256 indexed index, address indexed usr);
                    event Nope(address indexed owner, uint256 indexed index, address indexed usr);
                    event SelectVoteDelegate(address indexed owner, uint256 indexed index, address indexed voteDelegate);
                    event SelectFarm(address indexed owner, uint256 indexed index, address indexed farm, uint16 ref);
                    event Lock(address indexed owner, uint256 indexed index, uint256 wad, uint16 ref);
                    event Free(address indexed owner, uint256 indexed index, address to, uint256 wad, uint256 freed);
                    event FreeNoFee(address indexed owner, uint256 indexed index, address to, uint256 wad);
                    event Draw(address indexed owner, uint256 indexed index, address to, uint256 wad);
                    event Wipe(address indexed owner, uint256 indexed index, uint256 wad);
                    event GetReward(address indexed owner, uint256 indexed index, address indexed farm, address to, uint256 amt);
                    event OnKick(address indexed urn, uint256 wad);
                    event OnTake(address indexed urn, address indexed who, uint256 wad);
                    event OnRemove(address indexed urn, uint256 sold, uint256 burn, uint256 refund);
                    // --- modifiers ---
                    modifier auth {
                        require(wards[msg.sender] == 1, "LockstakeEngine/not-authorized");
                        _;
                    }
                    // --- constructor ---
                    constructor(address voteDelegateFactory_, address usdsJoin_, bytes32 ilk_, address sky_, address lssky_, uint256 fee_) {
                        require(fee_ < WAD, "LockstakeEngine/fee-equal-or-greater-wad");
                        voteDelegateFactory = VoteDelegateFactoryLike(voteDelegateFactory_);
                        usdsJoin = UsdsJoinLike(usdsJoin_);
                        vat = usdsJoin.vat();
                        usds = usdsJoin.usds();
                        ilk = ilk_;
                        sky = GemLike(sky_);
                        lssky = GemLike(lssky_);
                        fee = fee_;
                        urnImplementation = address(new LockstakeUrn(address(vat), lssky_));
                        vat.hope(usdsJoin_);
                        usds.approve(usdsJoin_, type(uint256).max);
                        wards[msg.sender] = 1;
                        emit Rely(msg.sender);
                    }
                    // --- internals ---
                    function _min(uint256 x, uint256 y) internal pure returns (uint256 z) {
                        z = x <= y ? x : y;
                    }
                    function _divup(uint256 x, uint256 y) internal pure returns (uint256 z) {
                        // Note: _divup(0,0) will return 0 differing from natural solidity division
                        unchecked {
                            z = x != 0 ? ((x - 1) / y) + 1 : 0;
                        }
                    }
                    function _urnAuth(address owner, address urn, address usr) internal view returns (bool ok) {
                        ok = owner == usr || urnCan[urn][usr] == 1;
                    }
                    function _getUrn(address owner, uint256 index) internal view returns (address urn) {
                        urn = ownerUrns[owner][index];
                        require(urn != address(0), "LockstakeEngine/invalid-urn");
                    }
                    function _getAuthedUrn(address owner, uint256 index) internal view returns (address urn) {
                        urn = _getUrn(owner, index);
                        require(_urnAuth(owner, urn, msg.sender), "LockstakeEngine/urn-not-authorized");
                    }
                    // See the reference implementation in https://eips.ethereum.org/EIPS/eip-1167
                    function _initCode() internal view returns (bytes memory code) {
                        code = new bytes(0x37);
                        bytes20 impl = bytes20(urnImplementation);
                        assembly {
                            mstore(add(code,     0x20),        0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000000000000000000000)
                            mstore(add(code, add(0x20, 0x14)), impl)
                            mstore(add(code, add(0x20, 0x28)), 0x5af43d82803e903d91602b57fd5bf30000000000000000000000000000000000)
                        }
                    }
                    // --- administration ---
                    function rely(address usr) external auth {
                        wards[usr] = 1;
                        emit Rely(usr);
                    }
                    function deny(address usr) external auth {
                        wards[usr] = 0;
                        emit Deny(usr);
                    }
                    function file(bytes32 what, address data) external auth {
                        if (what == "jug") {
                            jug = JugLike(data);
                        } else revert("LockstakeEngine/file-unrecognized-param");
                        emit File(what, data);
                    }
                    function addFarm(address farm) external auth {
                        farms[farm] = FarmStatus.ACTIVE;
                        emit AddFarm(farm);
                    }
                    function delFarm(address farm) external auth {
                        farms[farm] = FarmStatus.DELETED;
                        emit DelFarm(farm);
                    }
                    // --- getters ---
                    function isUrnAuth(address owner, uint256 index, address usr) external view returns (bool ok) {
                        ok = _urnAuth(owner, _getUrn(owner, index), usr);
                    }
                    // --- urn management functions ---
                    function open(uint256 index) external returns (address urn) {
                        require(index == ownerUrnsCount[msg.sender]++, "LockstakeEngine/wrong-urn-index");
                        bytes memory initCode = _initCode();
                        assembly { urn := create(0, add(initCode, 0x20), 0x37) }
                        LockstakeUrn(urn).init(); // would revert if create had failed
                        ownerUrns[msg.sender][index] = urn;
                        urnOwners[urn] = msg.sender;
                        emit Open(msg.sender, index, urn);
                    }
                    function hope(address owner, uint256 index, address usr) external {
                        address urn = _getAuthedUrn(owner, index);
                        urnCan[urn][usr] = 1;
                        emit Hope(owner, index, usr);
                    }
                    function nope(address owner, uint256 index, address usr) external {
                        address urn = _getAuthedUrn(owner, index);
                        urnCan[urn][usr] = 0;
                        emit Nope(owner, index, usr);
                    }
                    // --- delegation/staking functions ---
                    function selectVoteDelegate(address owner, uint256 index, address voteDelegate) external {
                        address urn = _getAuthedUrn(owner, index);
                        require(urnAuctions[urn] == 0, "LockstakeEngine/urn-in-auction");
                        require(voteDelegate == address(0) || voteDelegateFactory.created(voteDelegate) == 1, "LockstakeEngine/not-valid-vote-delegate");
                        address prevVoteDelegate = urnVoteDelegates[urn];
                        require(prevVoteDelegate != voteDelegate, "LockstakeEngine/same-vote-delegate");
                        (uint256 ink, uint256 art) = vat.urns(ilk, urn);
                        if (art > 0 && voteDelegate != address(0)) {
                            (,, uint256 spot,,) = vat.ilks(ilk);
                            require(ink * spot >= art * jug.drip(ilk), "LockstakeEngine/urn-unsafe");
                        }
                        _selectVoteDelegate(urn, ink, prevVoteDelegate, voteDelegate);
                        emit SelectVoteDelegate(owner, index, voteDelegate);
                    }
                    function _selectVoteDelegate(address urn, uint256 wad, address prevVoteDelegate, address voteDelegate) internal {
                        if (wad > 0) {
                            if (prevVoteDelegate != address(0)) {
                                VoteDelegateLike(prevVoteDelegate).free(wad);
                            }
                            if (voteDelegate != address(0)) {
                                sky.approve(voteDelegate, wad);
                                VoteDelegateLike(voteDelegate).lock(wad);
                            }
                        }
                        urnVoteDelegates[urn] = voteDelegate;
                    }
                    function selectFarm(address owner, uint256 index, address farm, uint16 ref) external {
                        address urn = _getAuthedUrn(owner, index);
                        require(urnAuctions[urn] == 0, "LockstakeEngine/urn-in-auction");
                        require(farm == address(0) || farms[farm] == FarmStatus.ACTIVE, "LockstakeEngine/farm-unsupported-or-deleted");
                        address prevFarm = urnFarms[urn];
                        require(prevFarm != farm, "LockstakeEngine/same-farm");
                        (uint256 ink,) = vat.urns(ilk, urn);
                        _selectFarm(urn, ink, prevFarm, farm, ref);
                        emit SelectFarm(owner, index, farm, ref);
                    }
                    function _selectFarm(address urn, uint256 wad, address prevFarm, address farm, uint16 ref) internal {
                        if (wad > 0) {
                            if (prevFarm != address(0)) {
                                LockstakeUrn(urn).withdraw(prevFarm, wad);
                            }
                            if (farm != address(0)) {
                                LockstakeUrn(urn).stake(farm, wad, ref);
                            }
                        }
                        urnFarms[urn] = farm;
                    }
                    function lock(address owner, uint256 index, uint256 wad, uint16 ref) external {
                        address urn = _getUrn(owner, index);
                        sky.transferFrom(msg.sender, address(this), wad);
                        require(wad <= uint256(type(int256).max), "LockstakeEngine/overflow");
                        address voteDelegate = urnVoteDelegates[urn];
                        if (voteDelegate != address(0)) {
                            sky.approve(voteDelegate, wad);
                            VoteDelegateLike(voteDelegate).lock(wad);
                        }
                        vat.slip(ilk, urn, int256(wad));
                        vat.frob(ilk, urn, urn, address(0), int256(wad), 0);
                        lssky.mint(urn, wad);
                        address urnFarm = urnFarms[urn];
                        if (urnFarm != address(0)) {
                            require(farms[urnFarm] == FarmStatus.ACTIVE, "LockstakeEngine/farm-deleted");
                            LockstakeUrn(urn).stake(urnFarm, wad, ref);
                        }
                        emit Lock(owner, index, wad, ref);
                    }
                    function free(address owner, uint256 index, address to, uint256 wad) external returns (uint256 freed) {
                        address urn = _getAuthedUrn(owner, index);
                        freed = _free(urn, wad, fee);
                        sky.transfer(to, freed);
                        emit Free(owner, index, to, wad, freed);
                    }
                    function freeNoFee(address owner, uint256 index, address to, uint256 wad) external auth {
                        address urn = _getAuthedUrn(owner, index);
                        _free(urn, wad, 0);
                        sky.transfer(to, wad);
                        emit FreeNoFee(owner, index, to, wad);
                    }
                    function _free(address urn, uint256 wad, uint256 fee_) internal returns (uint256 freed) {
                        require(wad <= uint256(type(int256).max), "LockstakeEngine/overflow");
                        address urnFarm = urnFarms[urn];
                        if (urnFarm != address(0)) {
                            LockstakeUrn(urn).withdraw(urnFarm, wad);
                        }
                        lssky.burn(urn, wad);
                        vat.frob(ilk, urn, urn, address(0), -int256(wad), 0);
                        vat.slip(ilk, urn, -int256(wad));
                        address voteDelegate = urnVoteDelegates[urn];
                        if (voteDelegate != address(0)) {
                            VoteDelegateLike(voteDelegate).free(wad);
                        }
                        uint256 burn = wad * fee_ / WAD;
                        if (burn > 0) {
                            sky.burn(address(this), burn);
                        }
                        unchecked { freed = wad - burn; } // burn <= wad always
                    }
                    // --- loan functions ---
                    function draw(address owner, uint256 index, address to, uint256 wad) external {
                        address urn = _getAuthedUrn(owner, index);
                        uint256 rate = jug.drip(ilk);
                        uint256 dart = _divup(wad * RAY, rate);
                        require(dart <= uint256(type(int256).max), "LockstakeEngine/overflow");
                        vat.frob(ilk, urn, address(0), address(this), 0, int256(dart));
                        usdsJoin.exit(to, wad);
                        emit Draw(owner, index, to, wad);
                    }
                    function wipe(address owner, uint256 index, uint256 wad) external {
                        address urn = _getUrn(owner, index);
                        usds.transferFrom(msg.sender, address(this), wad);
                        usdsJoin.join(address(this), wad);
                        (, uint256 rate,,,) = vat.ilks(ilk);
                        uint256 dart = wad * RAY / rate;
                        require(dart <= uint256(type(int256).max), "LockstakeEngine/overflow");
                        vat.frob(ilk, urn, address(0), address(this), 0, -int256(dart));
                        emit Wipe(owner, index, wad);
                    }
                    function wipeAll(address owner, uint256 index) external returns (uint256 wad) {
                        address urn = _getUrn(owner, index);
                        (, uint256 art) = vat.urns(ilk, urn);
                        require(art <= uint256(type(int256).max), "LockstakeEngine/overflow");
                        (, uint256 rate,,,) = vat.ilks(ilk);
                        wad = _divup(art * rate, RAY);
                        usds.transferFrom(msg.sender, address(this), wad);
                        usdsJoin.join(address(this), wad);
                        vat.frob(ilk, urn, address(0), address(this), 0, -int256(art));
                        emit Wipe(owner, index, wad);
                    }
                    // --- staking rewards function ---
                    function getReward(address owner, uint256 index, address farm, address to) external returns (uint256 amt) {
                        address urn = _getAuthedUrn(owner, index);
                        require(farms[farm] > FarmStatus.UNSUPPORTED, "LockstakeEngine/farm-unsupported");
                        amt = LockstakeUrn(urn).getReward(farm, to);
                        emit GetReward(owner, index, farm, to, amt);
                    }
                    // --- liquidation callback functions ---
                    function onKick(address urn, uint256 wad) external auth {
                        // Urn confiscation happens in Dog contract where ilk vat.gem is sent to the LockstakeClipper
                        (uint256 ink,) = vat.urns(ilk, urn);
                        uint256 inkBeforeKick = ink + wad;
                        _selectVoteDelegate(urn, inkBeforeKick, urnVoteDelegates[urn], address(0));
                        _selectFarm(urn, inkBeforeKick, urnFarms[urn], address(0), 0);
                        lssky.burn(urn, wad);
                        urnAuctions[urn]++;
                        emit OnKick(urn, wad);
                    }
                    function onTake(address urn, address who, uint256 wad) external auth {
                        sky.transfer(who, wad); // Free SKY to the auction buyer
                        emit OnTake(urn, who, wad);
                    }
                    function onRemove(address urn, uint256 sold, uint256 left) external auth {
                        uint256 burn;
                        uint256 refund;
                        if (left > 0) {
                            uint256 fee_ = fee;
                            burn = _min(sold * fee_ / (WAD - fee_), left);
                            sky.burn(address(this), burn);
                            unchecked { refund = left - burn; }
                            if (refund > 0) {
                                // The following is ensured by the dog and clip but we still prefer to be explicit
                                require(refund <= uint256(type(int256).max), "LockstakeEngine/overflow");
                                vat.slip(ilk, urn, int256(refund));
                                vat.grab(ilk, urn, urn, address(0), int256(refund), 0);
                                lssky.mint(urn, refund);
                            }
                        }
                        urnAuctions[urn]--;
                        emit OnRemove(urn, sold, burn, refund);
                    }
                }
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.21;
                interface VatLike {
                    function hope(address) external;
                }
                interface GemLike {
                    function balanceOf(address) external view returns (uint256);
                    function approve(address, uint256) external;
                    function transfer(address, uint256) external;
                }
                interface StakingRewardsLike {
                    function rewardsToken() external view returns (GemLike);
                    function stake(uint256, uint16) external;
                    function withdraw(uint256) external;
                    function getReward() external;
                }
                contract LockstakeUrn {
                    // --- immutables ---
                    address immutable public engine;
                    GemLike immutable public lssky;
                    VatLike immutable public vat;
                    // --- modifiers ---
                    modifier isEngine {
                        require(msg.sender == engine, "LockstakeUrn/not-engine");
                        _;
                    }
                    // --- constructor & init ---
                    constructor(address vat_, address lssky_) {
                        engine = msg.sender;
                        vat = VatLike(vat_);
                        lssky = GemLike(lssky_);
                    }
                    function init() external isEngine {
                        vat.hope(msg.sender);
                        lssky.approve(msg.sender, type(uint256).max);
                    }
                    // --- staking functions ---
                    function stake(address farm, uint256 wad, uint16 ref) external isEngine {
                        lssky.approve(farm, wad);
                        StakingRewardsLike(farm).stake(wad, ref);
                    }
                    function withdraw(address farm, uint256 wad) external isEngine {
                        StakingRewardsLike(farm).withdraw(wad);
                    }
                    function getReward(address farm, address to) external isEngine returns (uint256 amt) {
                        StakingRewardsLike(farm).getReward();
                        GemLike rewardsToken = StakingRewardsLike(farm).rewardsToken();
                        amt = rewardsToken.balanceOf(address(this));
                        rewardsToken.transfer(to, amt);
                    }
                }
                // SPDX-License-Identifier: GPL-2.0-or-later
                // Based on https://github.com/Uniswap/v3-periphery/blob/697c2474757ea89fec12a4e6db16a574fe259610/contracts/base/Multicall.sol
                pragma solidity ^0.8.21;
                // Enables calling multiple methods in a single call to the contract
                abstract contract Multicall  {
                    function multicall(bytes[] calldata data) external returns (bytes[] memory results) {
                        results = new bytes[](data.length);
                        for (uint256 i = 0; i < data.length; i++) {
                            (bool success, bytes memory result) = address(this).delegatecall(data[i]);
                            if (!success) {
                                if (result.length == 0) revert("multicall failed");
                                assembly ("memory-safe") {
                                    revert(add(32, result), mload(result))
                                }
                            }
                            results[i] = result;
                        }
                    }
                }
                

                File 2 of 5: ERC1967Proxy
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Proxy.sol)
                pragma solidity ^0.8.20;
                import {Proxy} from "../Proxy.sol";
                import {ERC1967Utils} from "./ERC1967Utils.sol";
                /**
                 * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
                 * implementation address that can be changed. This address is stored in storage in the location specified by
                 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
                 * implementation behind the proxy.
                 */
                contract ERC1967Proxy is Proxy {
                    /**
                     * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation`.
                     *
                     * If `_data` is nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
                     * encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
                     *
                     * Requirements:
                     *
                     * - If `data` is empty, `msg.value` must be zero.
                     */
                    constructor(address implementation, bytes memory _data) payable {
                        ERC1967Utils.upgradeToAndCall(implementation, _data);
                    }
                    /**
                     * @dev Returns the current implementation address.
                     *
                     * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using
                     * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                     * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                     */
                    function _implementation() internal view virtual override returns (address) {
                        return ERC1967Utils.getImplementation();
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/Proxy.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
                 * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
                 * be specified by overriding the virtual {_implementation} function.
                 *
                 * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
                 * different contract through the {_delegate} function.
                 *
                 * The success and return data of the delegated call will be returned back to the caller of the proxy.
                 */
                abstract contract Proxy {
                    /**
                     * @dev Delegates the current call to `implementation`.
                     *
                     * This function does not return to its internal call site, it will return directly to the external caller.
                     */
                    function _delegate(address implementation) internal virtual {
                        assembly {
                            // Copy msg.data. We take full control of memory in this inline assembly
                            // block because it will not return to Solidity code. We overwrite the
                            // Solidity scratch pad at memory position 0.
                            calldatacopy(0, 0, calldatasize())
                            // Call the implementation.
                            // out and outsize are 0 because we don't know the size yet.
                            let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                            // Copy the returned data.
                            returndatacopy(0, 0, returndatasize())
                            switch result
                            // delegatecall returns 0 on error.
                            case 0 {
                                revert(0, returndatasize())
                            }
                            default {
                                return(0, returndatasize())
                            }
                        }
                    }
                    /**
                     * @dev This is a virtual function that should be overridden so it returns the address to which the fallback
                     * function and {_fallback} should delegate.
                     */
                    function _implementation() internal view virtual returns (address);
                    /**
                     * @dev Delegates the current call to the address returned by `_implementation()`.
                     *
                     * This function does not return to its internal call site, it will return directly to the external caller.
                     */
                    function _fallback() internal virtual {
                        _delegate(_implementation());
                    }
                    /**
                     * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
                     * function in the contract matches the call data.
                     */
                    fallback() external payable virtual {
                        _fallback();
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)
                pragma solidity ^0.8.20;
                import {IBeacon} from "../beacon/IBeacon.sol";
                import {Address} from "../../utils/Address.sol";
                import {StorageSlot} from "../../utils/StorageSlot.sol";
                /**
                 * @dev This abstract contract provides getters and event emitting update functions for
                 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                 */
                library ERC1967Utils {
                    // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
                    // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
                    /**
                     * @dev Emitted when the implementation is upgraded.
                     */
                    event Upgraded(address indexed implementation);
                    /**
                     * @dev Emitted when the admin account has changed.
                     */
                    event AdminChanged(address previousAdmin, address newAdmin);
                    /**
                     * @dev Emitted when the beacon is changed.
                     */
                    event BeaconUpgraded(address indexed beacon);
                    /**
                     * @dev Storage slot with the address of the current implementation.
                     * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
                     */
                    // solhint-disable-next-line private-vars-leading-underscore
                    bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                    /**
                     * @dev The `implementation` of the proxy is invalid.
                     */
                    error ERC1967InvalidImplementation(address implementation);
                    /**
                     * @dev The `admin` of the proxy is invalid.
                     */
                    error ERC1967InvalidAdmin(address admin);
                    /**
                     * @dev The `beacon` of the proxy is invalid.
                     */
                    error ERC1967InvalidBeacon(address beacon);
                    /**
                     * @dev An upgrade function sees `msg.value > 0` that may be lost.
                     */
                    error ERC1967NonPayable();
                    /**
                     * @dev Returns the current implementation address.
                     */
                    function getImplementation() internal view returns (address) {
                        return StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value;
                    }
                    /**
                     * @dev Stores a new address in the EIP1967 implementation slot.
                     */
                    function _setImplementation(address newImplementation) private {
                        if (newImplementation.code.length == 0) {
                            revert ERC1967InvalidImplementation(newImplementation);
                        }
                        StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
                    }
                    /**
                     * @dev Performs implementation upgrade with additional setup call if data is nonempty.
                     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                     * to avoid stuck value in the contract.
                     *
                     * Emits an {IERC1967-Upgraded} event.
                     */
                    function upgradeToAndCall(address newImplementation, bytes memory data) internal {
                        _setImplementation(newImplementation);
                        emit Upgraded(newImplementation);
                        if (data.length > 0) {
                            Address.functionDelegateCall(newImplementation, data);
                        } else {
                            _checkNonPayable();
                        }
                    }
                    /**
                     * @dev Storage slot with the admin of the contract.
                     * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
                     */
                    // solhint-disable-next-line private-vars-leading-underscore
                    bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                    /**
                     * @dev Returns the current admin.
                     *
                     * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using
                     * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                     * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
                     */
                    function getAdmin() internal view returns (address) {
                        return StorageSlot.getAddressSlot(ADMIN_SLOT).value;
                    }
                    /**
                     * @dev Stores a new address in the EIP1967 admin slot.
                     */
                    function _setAdmin(address newAdmin) private {
                        if (newAdmin == address(0)) {
                            revert ERC1967InvalidAdmin(address(0));
                        }
                        StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
                    }
                    /**
                     * @dev Changes the admin of the proxy.
                     *
                     * Emits an {IERC1967-AdminChanged} event.
                     */
                    function changeAdmin(address newAdmin) internal {
                        emit AdminChanged(getAdmin(), newAdmin);
                        _setAdmin(newAdmin);
                    }
                    /**
                     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                     * This is the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
                     */
                    // solhint-disable-next-line private-vars-leading-underscore
                    bytes32 internal constant BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                    /**
                     * @dev Returns the current beacon.
                     */
                    function getBeacon() internal view returns (address) {
                        return StorageSlot.getAddressSlot(BEACON_SLOT).value;
                    }
                    /**
                     * @dev Stores a new beacon in the EIP1967 beacon slot.
                     */
                    function _setBeacon(address newBeacon) private {
                        if (newBeacon.code.length == 0) {
                            revert ERC1967InvalidBeacon(newBeacon);
                        }
                        StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;
                        address beaconImplementation = IBeacon(newBeacon).implementation();
                        if (beaconImplementation.code.length == 0) {
                            revert ERC1967InvalidImplementation(beaconImplementation);
                        }
                    }
                    /**
                     * @dev Change the beacon and trigger a setup call if data is nonempty.
                     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                     * to avoid stuck value in the contract.
                     *
                     * Emits an {IERC1967-BeaconUpgraded} event.
                     *
                     * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
                     * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
                     * efficiency.
                     */
                    function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
                        _setBeacon(newBeacon);
                        emit BeaconUpgraded(newBeacon);
                        if (data.length > 0) {
                            Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                        } else {
                            _checkNonPayable();
                        }
                    }
                    /**
                     * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
                     * if an upgrade doesn't perform an initialization call.
                     */
                    function _checkNonPayable() private {
                        if (msg.value > 0) {
                            revert ERC1967NonPayable();
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev This is the interface that {BeaconProxy} expects of its beacon.
                 */
                interface IBeacon {
                    /**
                     * @dev Must return an address that can be used as a delegate call target.
                     *
                     * {UpgradeableBeacon} will check that this address is a contract.
                     */
                    function implementation() external view returns (address);
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev Collection of functions related to the address type
                 */
                library Address {
                    /**
                     * @dev The ETH balance of the account is not enough to perform the operation.
                     */
                    error AddressInsufficientBalance(address account);
                    /**
                     * @dev There's no code at `target` (it is not a contract).
                     */
                    error AddressEmptyCode(address target);
                    /**
                     * @dev A call to an address target failed. The target may have reverted.
                     */
                    error FailedInnerCall();
                    /**
                     * @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 AddressInsufficientBalance(address(this));
                        }
                        (bool success, ) = recipient.call{value: amount}("");
                        if (!success) {
                            revert FailedInnerCall();
                        }
                    }
                    /**
                     * @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
                     * {FailedInnerCall} 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 AddressInsufficientBalance(address(this));
                        }
                        (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 {FailedInnerCall}) 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 {FailedInnerCall} 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 {FailedInnerCall}.
                     */
                    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
                            /// @solidity memory-safe-assembly
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert FailedInnerCall();
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
                // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
                pragma solidity ^0.8.20;
                /**
                 * @dev Library for reading and writing primitive types to specific storage slots.
                 *
                 * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                 * This library helps with reading and writing to such slots without the need for inline assembly.
                 *
                 * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                 *
                 * Example usage to set ERC1967 implementation slot:
                 * ```solidity
                 * contract ERC1967 {
                 *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                 *
                 *     function _getImplementation() internal view returns (address) {
                 *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                 *     }
                 *
                 *     function _setImplementation(address newImplementation) internal {
                 *         require(newImplementation.code.length > 0);
                 *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                 *     }
                 * }
                 * ```
                 */
                library StorageSlot {
                    struct AddressSlot {
                        address value;
                    }
                    struct BooleanSlot {
                        bool value;
                    }
                    struct Bytes32Slot {
                        bytes32 value;
                    }
                    struct Uint256Slot {
                        uint256 value;
                    }
                    struct StringSlot {
                        string value;
                    }
                    struct BytesSlot {
                        bytes value;
                    }
                    /**
                     * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                     */
                    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                     */
                    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                     */
                    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                     */
                    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `StringSlot` with member `value` located at `slot`.
                     */
                    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
                     */
                    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := store.slot
                        }
                    }
                    /**
                     * @dev Returns an `BytesSlot` with member `value` located at `slot`.
                     */
                    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
                     */
                    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := store.slot
                        }
                    }
                }
                

                File 3 of 5: StakingRewards
                /**
                 * NOTICE: This contract has been adapted from the original Synthetix source code:
                 *  - Upgrade Solidity version from 0.5.x to 0.8.x.
                 *  - Add referral code functionality for `stake()`.
                 *  - Update `setRewardDuration()` to support changing the reward duration during an active distribution.
                 *
                 * Original: https://github.com/Synthetixio/synthetix/blob/5e9096ac4aea6c4249828f1e8b95e3fb9be231f8/contracts/StakingRewards.sol
                 */
                // SPDX-FileCopyrightText: © 2019-2021 Synthetix
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: MIT AND AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.16;
                import {SafeERC20, IERC20} from "openzeppelin-contracts/token/ERC20/utils/SafeERC20.sol";
                import {ReentrancyGuard} from "openzeppelin-contracts/security/ReentrancyGuard.sol";
                import {IStakingRewards} from "./interfaces/IStakingRewards.sol";
                import {Pausable} from "./utils/Pausable.sol";
                // https://developer.synthetix.io/contracts/source/contracts/StakingRewards/
                contract StakingRewards is IStakingRewards, Pausable, ReentrancyGuard {
                    using SafeERC20 for IERC20;
                    /* ========== STATE VARIABLES ========== */
                    IERC20 public immutable rewardsToken;
                    IERC20 public immutable stakingToken;
                    address public rewardsDistribution;
                    uint256 public periodFinish = 0;
                    uint256 public rewardRate = 0;
                    uint256 public rewardsDuration = 7 days;
                    uint256 public lastUpdateTime;
                    uint256 public rewardPerTokenStored;
                    mapping(address => uint256) public userRewardPerTokenPaid;
                    mapping(address => uint256) public rewards;
                    uint256 private _totalSupply;
                    mapping(address => uint256) private _balances;
                    /* ========== CONSTRUCTOR ========== */
                    constructor(
                        address _owner,
                        address _rewardsDistribution,
                        address _rewardsToken,
                        address _stakingToken
                    ) Pausable(_owner) {
                        require(_rewardsToken != _stakingToken, "Rewards and staking tokens must not be the same");
                        rewardsToken = IERC20(_rewardsToken);
                        stakingToken = IERC20(_stakingToken);
                        rewardsDistribution = _rewardsDistribution;
                    }
                    /* ========== VIEWS ========== */
                    function totalSupply() external view returns (uint256) {
                        return _totalSupply;
                    }
                    function balanceOf(address account) external view returns (uint256) {
                        return _balances[account];
                    }
                    function lastTimeRewardApplicable() public view returns (uint256) {
                        return block.timestamp < periodFinish ? block.timestamp : periodFinish;
                    }
                    function rewardPerToken() public view returns (uint256) {
                        if (_totalSupply == 0) {
                            return rewardPerTokenStored;
                        }
                        return
                            rewardPerTokenStored + (((lastTimeRewardApplicable() - lastUpdateTime) * rewardRate * 1e18) / _totalSupply);
                    }
                    function earned(address account) public view returns (uint256) {
                        return (_balances[account] * (rewardPerToken() - userRewardPerTokenPaid[account])) / 1e18 + rewards[account];
                    }
                    function getRewardForDuration() external view returns (uint256) {
                        return rewardRate * rewardsDuration;
                    }
                    /* ========== MUTATIVE FUNCTIONS ========== */
                    function stake(uint256 amount) public nonReentrant notPaused updateReward(msg.sender) {
                        require(amount > 0, "Cannot stake 0");
                        _totalSupply = _totalSupply + amount;
                        _balances[msg.sender] = _balances[msg.sender] + amount;
                        stakingToken.safeTransferFrom(msg.sender, address(this), amount);
                        emit Staked(msg.sender, amount);
                    }
                    function stake(uint256 amount, uint16 referral) external {
                        stake(amount);
                        emit Referral(referral, msg.sender, amount);
                    }
                    function withdraw(uint256 amount) public nonReentrant updateReward(msg.sender) {
                        require(amount > 0, "Cannot withdraw 0");
                        _totalSupply = _totalSupply - amount;
                        _balances[msg.sender] = _balances[msg.sender] - amount;
                        stakingToken.safeTransfer(msg.sender, amount);
                        emit Withdrawn(msg.sender, amount);
                    }
                    function getReward() public nonReentrant updateReward(msg.sender) {
                        uint256 reward = rewards[msg.sender];
                        if (reward > 0) {
                            rewards[msg.sender] = 0;
                            rewardsToken.safeTransfer(msg.sender, reward);
                            emit RewardPaid(msg.sender, reward);
                        }
                    }
                    function exit() external {
                        withdraw(_balances[msg.sender]);
                        getReward();
                    }
                    /* ========== RESTRICTED FUNCTIONS ========== */
                    /// Before calling this function, the caller should send at least `reward` tokens to the contract.
                    /// Otherwise, if the amount sent is less than `reward` passed as a parameter,
                    /// the unclaimed rewards of other users would be used in the new period.
                    /// This would result in missing tokens, which might cause `getReward` to fail for some users.
                    /// We advise the use of wrapper contracts to perform the transfer and call this function atomically.
                    function notifyRewardAmount(uint256 reward) external override onlyRewardsDistribution updateReward(address(0)) {
                        if (block.timestamp >= periodFinish) {
                            rewardRate = reward / rewardsDuration;
                        } else {
                            uint256 remaining = periodFinish - block.timestamp;
                            uint256 leftover = remaining * rewardRate;
                            rewardRate = (reward + leftover) / rewardsDuration;
                        }
                        // Ensure the provided reward amount is not more than the balance in the contract.
                        // This keeps the reward rate in the right range, preventing overflows due to
                        // very high values of rewardRate in the earned and rewardsPerToken functions;
                        // Reward + leftover must be less than 2^256 / 10^18 to avoid overflow.
                        uint256 balance = rewardsToken.balanceOf(address(this));
                        require(rewardRate <= balance / rewardsDuration, "Provided reward too high");
                        lastUpdateTime = block.timestamp;
                        periodFinish = block.timestamp + rewardsDuration;
                        emit RewardAdded(reward);
                    }
                    // Added to support recovering LP Rewards from other systems such as BAL to be distributed to holders
                    function recoverERC20(address tokenAddress, uint256 tokenAmount) external onlyOwner {
                        require(tokenAddress != address(stakingToken), "Cannot withdraw the staking token");
                        IERC20(tokenAddress).safeTransfer(owner, tokenAmount);
                        emit Recovered(tokenAddress, tokenAmount);
                    }
                    function setRewardsDuration(uint256 _rewardsDuration) external onlyOwner updateReward(address(0)) {
                        uint256 periodFinish_ = periodFinish;
                        if (block.timestamp < periodFinish_) {
                            uint256 leftover = (periodFinish_ - block.timestamp) * rewardRate;
                            rewardRate = leftover / _rewardsDuration;
                            periodFinish = block.timestamp + _rewardsDuration;
                        }
                        rewardsDuration = _rewardsDuration;
                        emit RewardsDurationUpdated(rewardsDuration);
                    }
                    function setRewardsDistribution(address _rewardsDistribution) external onlyOwner {
                        rewardsDistribution = _rewardsDistribution;
                        emit RewardsDistributionUpdated(rewardsDistribution);
                    }
                    /* ========== MODIFIERS ========== */
                    modifier updateReward(address account) {
                        rewardPerTokenStored = rewardPerToken();
                        lastUpdateTime = lastTimeRewardApplicable();
                        if (account != address(0)) {
                            rewards[account] = earned(account);
                            userRewardPerTokenPaid[account] = rewardPerTokenStored;
                        }
                        _;
                    }
                    modifier onlyRewardsDistribution() {
                        require(msg.sender == rewardsDistribution, "Caller is not RewardsDistribution contract");
                        _;
                    }
                    /* ========== EVENTS ========== */
                    event RewardAdded(uint256 reward);
                    event Staked(address indexed user, uint256 amount);
                    event Referral(uint16 indexed referral, address indexed user, uint256 amount);
                    event Withdrawn(address indexed user, uint256 amount);
                    event RewardPaid(address indexed user, uint256 reward);
                    event RewardsDurationUpdated(uint256 newDuration);
                    event RewardsDistributionUpdated(address newRewardsDistribution);
                    event Recovered(address token, uint256 amount);
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/utils/SafeERC20.sol)
                pragma solidity ^0.8.0;
                import "../IERC20.sol";
                import "../extensions/draft-IERC20Permit.sol";
                import "../../../utils/Address.sol";
                /**
                 * @title SafeERC20
                 * @dev Wrappers around ERC20 operations that throw on failure (when the token
                 * contract returns false). Tokens that return no value (and instead revert or
                 * throw on failure) are also supported, non-reverting calls are assumed to be
                 * successful.
                 * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
                 * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
                 */
                library SafeERC20 {
                    using Address for address;
                    function safeTransfer(
                        IERC20 token,
                        address to,
                        uint256 value
                    ) internal {
                        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                    }
                    function safeTransferFrom(
                        IERC20 token,
                        address from,
                        address to,
                        uint256 value
                    ) internal {
                        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                    }
                    /**
                     * @dev Deprecated. This function has issues similar to the ones found in
                     * {IERC20-approve}, and its usage is discouraged.
                     *
                     * Whenever possible, use {safeIncreaseAllowance} and
                     * {safeDecreaseAllowance} instead.
                     */
                    function safeApprove(
                        IERC20 token,
                        address spender,
                        uint256 value
                    ) internal {
                        // safeApprove should only be called when setting an initial allowance,
                        // or when resetting it to zero. To increase and decrease it, use
                        // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
                        require(
                            (value == 0) || (token.allowance(address(this), spender) == 0),
                            "SafeERC20: approve from non-zero to non-zero allowance"
                        );
                        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
                    }
                    function safeIncreaseAllowance(
                        IERC20 token,
                        address spender,
                        uint256 value
                    ) internal {
                        uint256 newAllowance = token.allowance(address(this), spender) + value;
                        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                    }
                    function safeDecreaseAllowance(
                        IERC20 token,
                        address spender,
                        uint256 value
                    ) internal {
                        unchecked {
                            uint256 oldAllowance = token.allowance(address(this), spender);
                            require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
                            uint256 newAllowance = oldAllowance - value;
                            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
                        }
                    }
                    function safePermit(
                        IERC20Permit token,
                        address owner,
                        address spender,
                        uint256 value,
                        uint256 deadline,
                        uint8 v,
                        bytes32 r,
                        bytes32 s
                    ) internal {
                        uint256 nonceBefore = token.nonces(owner);
                        token.permit(owner, spender, value, deadline, v, r, s);
                        uint256 nonceAfter = token.nonces(owner);
                        require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
                    }
                    /**
                     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                     * on the return value: the return value is optional (but if data is returned, it must not be false).
                     * @param token The token targeted by the call.
                     * @param data The call data (encoded using abi.encode or one of its variants).
                     */
                    function _callOptionalReturn(IERC20 token, bytes memory data) private {
                        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                        // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
                        // the target address contains contract code and also asserts for success in the low-level call.
                        bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                        if (returndata.length > 0) {
                            // Return data is optional
                            require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v4.8.0) (security/ReentrancyGuard.sol)
                pragma solidity ^0.8.0;
                /**
                 * @dev Contract module that helps prevent reentrant calls to a function.
                 *
                 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
                 * available, which can be applied to functions to make sure there are no nested
                 * (reentrant) calls to them.
                 *
                 * Note that because there is a single `nonReentrant` guard, functions marked as
                 * `nonReentrant` may not call one another. This can be worked around by making
                 * those functions `private`, and then adding `external` `nonReentrant` entry
                 * points to them.
                 *
                 * TIP: If you would like to learn more about reentrancy and alternative ways
                 * to protect against it, check out our blog post
                 * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
                 */
                abstract contract ReentrancyGuard {
                    // Booleans are more expensive than uint256 or any type that takes up a full
                    // word because each write operation emits an extra SLOAD to first read the
                    // slot's contents, replace the bits taken up by the boolean, and then write
                    // back. This is the compiler's defense against contract upgrades and
                    // pointer aliasing, and it cannot be disabled.
                    // The values being non-zero value makes deployment a bit more expensive,
                    // but in exchange the refund on every call to nonReentrant will be lower in
                    // amount. Since refunds are capped to a percentage of the total
                    // transaction's gas, it is best to keep them low in cases like this one, to
                    // increase the likelihood of the full refund coming into effect.
                    uint256 private constant _NOT_ENTERED = 1;
                    uint256 private constant _ENTERED = 2;
                    uint256 private _status;
                    constructor() {
                        _status = _NOT_ENTERED;
                    }
                    /**
                     * @dev Prevents a contract from calling itself, directly or indirectly.
                     * Calling a `nonReentrant` function from another `nonReentrant`
                     * function is not supported. It is possible to prevent this from happening
                     * by making the `nonReentrant` function external, and making it call a
                     * `private` function that does the actual work.
                     */
                    modifier nonReentrant() {
                        _nonReentrantBefore();
                        _;
                        _nonReentrantAfter();
                    }
                    function _nonReentrantBefore() private {
                        // On the first call to nonReentrant, _status will be _NOT_ENTERED
                        require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
                        // Any calls to nonReentrant after this point will fail
                        _status = _ENTERED;
                    }
                    function _nonReentrantAfter() private {
                        // By storing the original value once again, a refund is triggered (see
                        // https://eips.ethereum.org/EIPS/eip-2200)
                        _status = _NOT_ENTERED;
                    }
                }
                // SPDX-FileCopyrightText: © 2019-2021 Synthetix
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: MIT AND AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.16;
                import {IERC20} from "openzeppelin-contracts/token/ERC20/utils/SafeERC20.sol";
                // https://docs.synthetix.io/contracts/source/interfaces/istakingrewards
                interface IStakingRewards {
                    // Views
                    function balanceOf(address account) external view returns (uint256);
                    function earned(address account) external view returns (uint256);
                    function getRewardForDuration() external view returns (uint256);
                    function lastTimeRewardApplicable() external view returns (uint256);
                    function rewardPerToken() external view returns (uint256);
                    function rewardsDistribution() external view returns (address);
                    function rewardsToken() external view returns (IERC20);
                    function stakingToken() external view returns (IERC20);
                    function totalSupply() external view returns (uint256);
                    // Mutative
                    function exit() external;
                    function getReward() external;
                    function stake(uint256 amount) external;
                    function stake(uint256 amount, uint16 referral) external;
                    function withdraw(uint256 amount) external;
                    function notifyRewardAmount(uint256 reward) external;
                    function setRewardsDistribution(address _rewardsDistribution) external;
                    function setRewardsDuration(uint256 _rewardsDuration) external;
                    function recoverERC20(address tokenAddress, uint256 tokenAmount) external;
                }
                /**
                 * NOTICE: This contract has been adapted from the original Synthetix source code:
                 *  - Upgrade Solidity version from 0.5.x to 0.8.x.
                 *
                 * Original: https://github.com/Synthetixio/synthetix/blob/5e9096ac4aea6c4249828f1e8b95e3fb9be231f8/contracts/Pausable.sol
                 *     Diff: https://www.diffchecker.com/ZxqWAZxN/
                 */
                // SPDX-FileCopyrightText: © 2019-2021 Synthetix
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: MIT AND AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.16;
                // Inheritance
                import {Owned} from "./Owned.sol";
                // https://developer.synthetix.io/contracts/source/contracts/Pausable/
                abstract contract Pausable is Owned {
                    uint public lastPauseTime;
                    bool public paused;
                    constructor(address _owner) Owned(_owner) {}
                    /**
                     * @notice Change the paused state of the contract
                     * @dev Only the contract owner may call this.
                     */
                    function setPaused(bool _paused) external onlyOwner {
                        // Ensure we're actually changing the state before we do anything
                        if (_paused == paused) {
                            return;
                        }
                        // Set our paused state.
                        paused = _paused;
                        // If applicable, set the last pause time.
                        if (paused) {
                            lastPauseTime = block.timestamp;
                        }
                        // Let everyone know that our pause state has changed.
                        emit PauseChanged(paused);
                    }
                    event PauseChanged(bool isPaused);
                    modifier notPaused() {
                        require(!paused, "This action cannot be performed while the contract is paused");
                        _;
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
                pragma solidity ^0.8.0;
                /**
                 * @dev Interface of the ERC20 standard as defined in the EIP.
                 */
                interface IERC20 {
                    /**
                     * @dev Emitted when `value` tokens are moved from one account (`from`) to
                     * another (`to`).
                     *
                     * Note that `value` may be zero.
                     */
                    event Transfer(address indexed from, address indexed to, uint256 value);
                    /**
                     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
                     * a call to {approve}. `value` is the new allowance.
                     */
                    event Approval(address indexed owner, address indexed spender, uint256 value);
                    /**
                     * @dev Returns the amount of tokens in existence.
                     */
                    function totalSupply() external view returns (uint256);
                    /**
                     * @dev Returns the amount of tokens owned by `account`.
                     */
                    function balanceOf(address account) external view returns (uint256);
                    /**
                     * @dev Moves `amount` tokens from the caller's account to `to`.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transfer(address to, uint256 amount) external returns (bool);
                    /**
                     * @dev Returns the remaining number of tokens that `spender` will be
                     * allowed to spend on behalf of `owner` through {transferFrom}. This is
                     * zero by default.
                     *
                     * This value changes when {approve} or {transferFrom} are called.
                     */
                    function allowance(address owner, address spender) external view returns (uint256);
                    /**
                     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * IMPORTANT: Beware that changing an allowance with this method brings the risk
                     * that someone may use both the old and the new allowance by unfortunate
                     * transaction ordering. One possible solution to mitigate this race
                     * condition is to first reduce the spender's allowance to 0 and set the
                     * desired value afterwards:
                     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
                     *
                     * Emits an {Approval} event.
                     */
                    function approve(address spender, uint256 amount) external returns (bool);
                    /**
                     * @dev Moves `amount` tokens from `from` to `to` using the
                     * allowance mechanism. `amount` is then deducted from the caller's
                     * allowance.
                     *
                     * Returns a boolean value indicating whether the operation succeeded.
                     *
                     * Emits a {Transfer} event.
                     */
                    function transferFrom(
                        address from,
                        address to,
                        uint256 amount
                    ) external returns (bool);
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol)
                pragma solidity ^0.8.0;
                /**
                 * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
                 * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
                 *
                 * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
                 * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
                 * need to send a transaction, and thus is not required to hold Ether at all.
                 */
                interface IERC20Permit {
                    /**
                     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
                     * given ``owner``'s signed approval.
                     *
                     * IMPORTANT: The same issues {IERC20-approve} has related to transaction
                     * ordering also apply here.
                     *
                     * Emits an {Approval} event.
                     *
                     * Requirements:
                     *
                     * - `spender` cannot be the zero address.
                     * - `deadline` must be a timestamp in the future.
                     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
                     * over the EIP712-formatted function arguments.
                     * - the signature must use ``owner``'s current nonce (see {nonces}).
                     *
                     * For more information on the signature format, see the
                     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
                     * section].
                     */
                    function permit(
                        address owner,
                        address spender,
                        uint256 value,
                        uint256 deadline,
                        uint8 v,
                        bytes32 r,
                        bytes32 s
                    ) external;
                    /**
                     * @dev Returns the current nonce for `owner`. This value must be
                     * included whenever a signature is generated for {permit}.
                     *
                     * Every successful call to {permit} increases ``owner``'s nonce by one. This
                     * prevents a signature from being used multiple times.
                     */
                    function nonces(address owner) external view returns (uint256);
                    /**
                     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
                     */
                    // solhint-disable-next-line func-name-mixedcase
                    function DOMAIN_SEPARATOR() external view returns (bytes32);
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
                pragma solidity ^0.8.1;
                /**
                 * @dev Collection of functions related to the address type
                 */
                library Address {
                    /**
                     * @dev Returns true if `account` is a contract.
                     *
                     * [IMPORTANT]
                     * ====
                     * It is unsafe to assume that an address for which this function returns
                     * false is an externally-owned account (EOA) and not a contract.
                     *
                     * Among others, `isContract` will return false for the following
                     * types of addresses:
                     *
                     *  - an externally-owned account
                     *  - a contract in construction
                     *  - an address where a contract will be created
                     *  - an address where a contract lived, but was destroyed
                     * ====
                     *
                     * [IMPORTANT]
                     * ====
                     * You shouldn't rely on `isContract` to protect against flash loan attacks!
                     *
                     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
                     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
                     * constructor.
                     * ====
                     */
                    function isContract(address account) internal view returns (bool) {
                        // This method relies on extcodesize/address.code.length, which returns 0
                        // for contracts in construction, since the code is only stored at the end
                        // of the constructor execution.
                        return account.code.length > 0;
                    }
                    /**
                     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                     * `recipient`, forwarding all available gas and reverting on errors.
                     *
                     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                     * of certain opcodes, possibly making contracts go over the 2300 gas limit
                     * imposed by `transfer`, making them unable to receive funds via
                     * `transfer`. {sendValue} removes this limitation.
                     *
                     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                     *
                     * IMPORTANT: because control is transferred to `recipient`, care must be
                     * taken to not create reentrancy vulnerabilities. Consider using
                     * {ReentrancyGuard} or the
                     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                     */
                    function sendValue(address payable recipient, uint256 amount) internal {
                        require(address(this).balance >= amount, "Address: insufficient balance");
                        (bool success, ) = recipient.call{value: amount}("");
                        require(success, "Address: unable to send value, recipient may have reverted");
                    }
                    /**
                     * @dev Performs a Solidity function call using a low level `call`. A
                     * plain `call` is an unsafe replacement for a function call: use this
                     * function instead.
                     *
                     * If `target` reverts with a revert reason, it is bubbled up by this
                     * function (like regular Solidity function calls).
                     *
                     * Returns the raw returned data. To convert to the expected return value,
                     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                     *
                     * Requirements:
                     *
                     * - `target` must be a contract.
                     * - calling `target` with `data` must not revert.
                     *
                     * _Available since v3.1._
                     */
                    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                        return functionCallWithValue(target, data, 0, "Address: low-level call failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
                     * `errorMessage` as a fallback revert reason when `target` reverts.
                     *
                     * _Available since v3.1._
                     */
                    function functionCall(
                        address target,
                        bytes memory data,
                        string memory errorMessage
                    ) internal returns (bytes memory) {
                        return functionCallWithValue(target, data, 0, errorMessage);
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but also transferring `value` wei to `target`.
                     *
                     * Requirements:
                     *
                     * - the calling contract must have an ETH balance of at least `value`.
                     * - the called Solidity function must be `payable`.
                     *
                     * _Available since v3.1._
                     */
                    function functionCallWithValue(
                        address target,
                        bytes memory data,
                        uint256 value
                    ) internal returns (bytes memory) {
                        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
                     * with `errorMessage` as a fallback revert reason when `target` reverts.
                     *
                     * _Available since v3.1._
                     */
                    function functionCallWithValue(
                        address target,
                        bytes memory data,
                        uint256 value,
                        string memory errorMessage
                    ) internal returns (bytes memory) {
                        require(address(this).balance >= value, "Address: insufficient balance for call");
                        (bool success, bytes memory returndata) = target.call{value: value}(data);
                        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but performing a static call.
                     *
                     * _Available since v3.3._
                     */
                    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                        return functionStaticCall(target, data, "Address: low-level static call failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                     * but performing a static call.
                     *
                     * _Available since v3.3._
                     */
                    function functionStaticCall(
                        address target,
                        bytes memory data,
                        string memory errorMessage
                    ) internal view returns (bytes memory) {
                        (bool success, bytes memory returndata) = target.staticcall(data);
                        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                     * but performing a delegate call.
                     *
                     * _Available since v3.4._
                     */
                    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
                    }
                    /**
                     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
                     * but performing a delegate call.
                     *
                     * _Available since v3.4._
                     */
                    function functionDelegateCall(
                        address target,
                        bytes memory data,
                        string memory errorMessage
                    ) internal returns (bytes memory) {
                        (bool success, bytes memory returndata) = target.delegatecall(data);
                        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
                    }
                    /**
                     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
                     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
                     *
                     * _Available since v4.8._
                     */
                    function verifyCallResultFromTarget(
                        address target,
                        bool success,
                        bytes memory returndata,
                        string memory errorMessage
                    ) internal view returns (bytes memory) {
                        if (success) {
                            if (returndata.length == 0) {
                                // only check isContract if the call was successful and the return data is empty
                                // otherwise we already know that it was a contract
                                require(isContract(target), "Address: call to non-contract");
                            }
                            return returndata;
                        } else {
                            _revert(returndata, errorMessage);
                        }
                    }
                    /**
                     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
                     * revert reason or using the provided one.
                     *
                     * _Available since v4.3._
                     */
                    function verifyCallResult(
                        bool success,
                        bytes memory returndata,
                        string memory errorMessage
                    ) internal pure returns (bytes memory) {
                        if (success) {
                            return returndata;
                        } else {
                            _revert(returndata, errorMessage);
                        }
                    }
                    function _revert(bytes memory returndata, string memory errorMessage) private pure {
                        // Look for revert reason and bubble it up if present
                        if (returndata.length > 0) {
                            // The easiest way to bubble the revert reason is using memory via assembly
                            /// @solidity memory-safe-assembly
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert(errorMessage);
                        }
                    }
                }
                /**
                 * NOTICE: This contract has been adapted from the original Synthetix source code:
                 *  - Upgrade Solidity version from 0.5.x to 0.8.x.
                 *
                 * Original: https://github.com/Synthetixio/synthetix/blob/5e9096ac4aea6c4249828f1e8b95e3fb9be231f8/contracts/Owned.sol
                 *     Diff: https://www.diffchecker.com/pvwfv0hH/
                 */
                // SPDX-FileCopyrightText: © 2019-2021 Synthetix
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: MIT AND AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.16;
                // https://developer.synthetix.io/contracts/source/contracts/Owned/
                contract Owned {
                    address public owner;
                    address public nominatedOwner;
                    constructor(address _owner) {
                        require(_owner != address(0), "Owner address cannot be 0");
                        owner = _owner;
                        emit OwnerChanged(address(0), _owner);
                    }
                    function nominateNewOwner(address _owner) external onlyOwner {
                        nominatedOwner = _owner;
                        emit OwnerNominated(_owner);
                    }
                    function acceptOwnership() external {
                        require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                        emit OwnerChanged(owner, nominatedOwner);
                        owner = nominatedOwner;
                        nominatedOwner = address(0);
                    }
                    modifier onlyOwner() {
                        _onlyOwner();
                        _;
                    }
                    function _onlyOwner() private view {
                        require(msg.sender == owner, "Only the contract owner may perform this action");
                    }
                    event OwnerNominated(address newOwner);
                    event OwnerChanged(address oldOwner, address newOwner);
                }
                

                File 4 of 5: LockstakeUrn
                // SPDX-FileCopyrightText: © 2023 Dai Foundation <www.daifoundation.org>
                // SPDX-License-Identifier: AGPL-3.0-or-later
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.21;
                interface VatLike {
                    function hope(address) external;
                }
                interface GemLike {
                    function balanceOf(address) external view returns (uint256);
                    function approve(address, uint256) external;
                    function transfer(address, uint256) external;
                }
                interface StakingRewardsLike {
                    function rewardsToken() external view returns (GemLike);
                    function stake(uint256, uint16) external;
                    function withdraw(uint256) external;
                    function getReward() external;
                }
                contract LockstakeUrn {
                    // --- immutables ---
                    address immutable public engine;
                    GemLike immutable public lssky;
                    VatLike immutable public vat;
                    // --- modifiers ---
                    modifier isEngine {
                        require(msg.sender == engine, "LockstakeUrn/not-engine");
                        _;
                    }
                    // --- constructor & init ---
                    constructor(address vat_, address lssky_) {
                        engine = msg.sender;
                        vat = VatLike(vat_);
                        lssky = GemLike(lssky_);
                    }
                    function init() external isEngine {
                        vat.hope(msg.sender);
                        lssky.approve(msg.sender, type(uint256).max);
                    }
                    // --- staking functions ---
                    function stake(address farm, uint256 wad, uint16 ref) external isEngine {
                        lssky.approve(farm, wad);
                        StakingRewardsLike(farm).stake(wad, ref);
                    }
                    function withdraw(address farm, uint256 wad) external isEngine {
                        StakingRewardsLike(farm).withdraw(wad);
                    }
                    function getReward(address farm, address to) external isEngine returns (uint256 amt) {
                        StakingRewardsLike(farm).getReward();
                        GemLike rewardsToken = StakingRewardsLike(farm).rewardsToken();
                        amt = rewardsToken.balanceOf(address(this));
                        rewardsToken.transfer(to, amt);
                    }
                }
                

                File 5 of 5: Usds
                // SPDX-License-Identifier: AGPL-3.0-or-later
                /// Usds.sol -- Usds token
                // Copyright (C) 2017, 2018, 2019 dbrock, rain, mrchico
                // Copyright (C) 2023 Dai Foundation
                //
                // This program is free software: you can redistribute it and/or modify
                // it under the terms of the GNU Affero General Public License as published by
                // the Free Software Foundation, either version 3 of the License, or
                // (at your option) any later version.
                //
                // This program is distributed in the hope that it will be useful,
                // but WITHOUT ANY WARRANTY; without even the implied warranty of
                // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                // GNU Affero General Public License for more details.
                //
                // You should have received a copy of the GNU Affero General Public License
                // along with this program.  If not, see <https://www.gnu.org/licenses/>.
                pragma solidity ^0.8.21;
                import "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
                interface IERC1271 {
                    function isValidSignature(
                        bytes32,
                        bytes memory
                    ) external view returns (bytes4);
                }
                contract Usds is UUPSUpgradeable {
                    mapping (address => uint256) public wards;
                    // --- ERC20 Data ---
                    string  public constant name     = "USDS Stablecoin";
                    string  public constant symbol   = "USDS";
                    string  public constant version  = "1";
                    uint8   public constant decimals = 18;
                    uint256 public totalSupply;
                    mapping (address => uint256)                      public balanceOf;
                    mapping (address => mapping (address => uint256)) public allowance;
                    mapping (address => uint256)                      public nonces;
                    // --- Events ---
                    event Rely(address indexed usr);
                    event Deny(address indexed usr);
                    event Approval(address indexed owner, address indexed spender, uint256 value);
                    event Transfer(address indexed from, address indexed to, uint256 value);
                    // --- EIP712 niceties ---
                    bytes32 public constant PERMIT_TYPEHASH = keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
                    modifier auth {
                        require(wards[msg.sender] == 1, "Usds/not-authorized");
                        _;
                    }
                    constructor() {
                        _disableInitializers(); // Avoid initializing in the context of the implementation
                    }
                    // --- Upgradability ---
                    function initialize() initializer external {
                        __UUPSUpgradeable_init();
                        wards[msg.sender] = 1;
                        emit Rely(msg.sender);
                    }
                    function _authorizeUpgrade(address newImplementation) internal override auth {}
                    function getImplementation() external view returns (address) {
                        return ERC1967Utils.getImplementation();
                    }
                    function _calculateDomainSeparator(uint256 chainId) private view returns (bytes32) {
                        return keccak256(
                            abi.encode(
                                keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"),
                                keccak256(bytes(name)),
                                keccak256(bytes(version)),
                                chainId,
                                address(this)
                            )
                        );
                    }
                    function DOMAIN_SEPARATOR() external view returns (bytes32) {
                        return _calculateDomainSeparator(block.chainid);
                    }
                    // --- Administration ---
                    function rely(address usr) external auth {
                        wards[usr] = 1;
                        emit Rely(usr);
                    }
                    function deny(address usr) external auth {
                        wards[usr] = 0;
                        emit Deny(usr);
                    }
                    // --- ERC20 Mutations ---
                    function transfer(address to, uint256 value) external returns (bool) {
                        require(to != address(0) && to != address(this), "Usds/invalid-address");
                        uint256 balance = balanceOf[msg.sender];
                        require(balance >= value, "Usds/insufficient-balance");
                        unchecked {
                            balanceOf[msg.sender] = balance - value;
                            balanceOf[to] += value; // note: we don't need an overflow check here b/c sum of all balances == totalSupply
                        }
                        emit Transfer(msg.sender, to, value);
                        return true;
                    }
                    function transferFrom(address from, address to, uint256 value) external returns (bool) {
                        require(to != address(0) && to != address(this), "Usds/invalid-address");
                        uint256 balance = balanceOf[from];
                        require(balance >= value, "Usds/insufficient-balance");
                        if (from != msg.sender) {
                            uint256 allowed = allowance[from][msg.sender];
                            if (allowed != type(uint256).max) {
                                require(allowed >= value, "Usds/insufficient-allowance");
                                unchecked {
                                    allowance[from][msg.sender] = allowed - value;
                                }
                            }
                        }
                        unchecked {
                            balanceOf[from] = balance - value;
                            balanceOf[to] += value; // note: we don't need an overflow check here b/c sum of all balances == totalSupply
                        }
                        emit Transfer(from, to, value);
                        return true;
                    }
                    function approve(address spender, uint256 value) external returns (bool) {
                        allowance[msg.sender][spender] = value;
                        emit Approval(msg.sender, spender, value);
                        return true;
                    }
                    // --- Mint/Burn ---
                    function mint(address to, uint256 value) external auth {
                        require(to != address(0) && to != address(this), "Usds/invalid-address");
                        unchecked {
                            balanceOf[to] = balanceOf[to] + value; // note: we don't need an overflow check here b/c balanceOf[to] <= totalSupply and there is an overflow check below
                        }
                        totalSupply = totalSupply + value;
                        emit Transfer(address(0), to, value);
                    }
                    function burn(address from, uint256 value) external {
                        uint256 balance = balanceOf[from];
                        require(balance >= value, "Usds/insufficient-balance");
                        if (from != msg.sender) {
                            uint256 allowed = allowance[from][msg.sender];
                            if (allowed != type(uint256).max) {
                                require(allowed >= value, "Usds/insufficient-allowance");
                                unchecked {
                                    allowance[from][msg.sender] = allowed - value;
                                }
                            }
                        }
                        unchecked {
                            balanceOf[from] = balance - value; // note: we don't need overflow checks b/c require(balance >= value) and balance <= totalSupply
                            totalSupply     = totalSupply - value;
                        }
                        emit Transfer(from, address(0), value);
                    }
                    // --- Approve by signature ---
                    function _isValidSignature(
                        address signer,
                        bytes32 digest,
                        bytes memory signature
                    ) internal view returns (bool valid) {
                        if (signature.length == 65) {
                            bytes32 r;
                            bytes32 s;
                            uint8 v;
                            assembly {
                                r := mload(add(signature, 0x20))
                                s := mload(add(signature, 0x40))
                                v := byte(0, mload(add(signature, 0x60)))
                            }
                            if (signer == ecrecover(digest, v, r, s)) {
                                return true;
                            }
                        }
                        if (signer.code.length > 0) {
                            (bool success, bytes memory result) = signer.staticcall(
                                abi.encodeCall(IERC1271.isValidSignature, (digest, signature))
                            );
                            valid = (success &&
                                result.length == 32 &&
                                abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector);
                        }
                    }
                    function permit(
                        address owner,
                        address spender,
                        uint256 value,
                        uint256 deadline,
                        bytes memory signature
                    ) public {
                        require(block.timestamp <= deadline, "Usds/permit-expired");
                        require(owner != address(0), "Usds/invalid-owner");
                        uint256 nonce;
                        unchecked { nonce = nonces[owner]++; }
                        bytes32 digest =
                            keccak256(abi.encodePacked(
                                "\\x19\\x01",
                                _calculateDomainSeparator(block.chainid),
                                keccak256(abi.encode(
                                    PERMIT_TYPEHASH,
                                    owner,
                                    spender,
                                    value,
                                    nonce,
                                    deadline
                                ))
                            ));
                        require(_isValidSignature(owner, digest, signature), "Usds/invalid-permit");
                        allowance[owner][spender] = value;
                        emit Approval(owner, spender, value);
                    }
                    function permit(
                        address owner,
                        address spender,
                        uint256 value,
                        uint256 deadline,
                        uint8 v,
                        bytes32 r,
                        bytes32 s
                    ) external {
                        permit(owner, spender, value, deadline, abi.encodePacked(r, s, v));
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/UUPSUpgradeable.sol)
                pragma solidity ^0.8.20;
                import {IERC1822Proxiable} from "@openzeppelin/contracts/interfaces/draft-IERC1822.sol";
                import {ERC1967Utils} from "@openzeppelin/contracts/proxy/ERC1967/ERC1967Utils.sol";
                import {Initializable} from "./Initializable.sol";
                /**
                 * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
                 * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
                 *
                 * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
                 * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
                 * `UUPSUpgradeable` with a custom implementation of upgrades.
                 *
                 * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
                 */
                abstract contract UUPSUpgradeable is Initializable, IERC1822Proxiable {
                    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
                    address private immutable __self = address(this);
                    /**
                     * @dev The version of the upgrade interface of the contract. If this getter is missing, both `upgradeTo(address)`
                     * and `upgradeToAndCall(address,bytes)` are present, and `upgradeTo` must be used if no function should be called,
                     * while `upgradeToAndCall` will invoke the `receive` function if the second argument is the empty byte string.
                     * If the getter returns `"5.0.0"`, only `upgradeToAndCall(address,bytes)` is present, and the second argument must
                     * be the empty byte string if no function should be called, making it impossible to invoke the `receive` function
                     * during an upgrade.
                     */
                    string public constant UPGRADE_INTERFACE_VERSION = "5.0.0";
                    /**
                     * @dev The call is from an unauthorized context.
                     */
                    error UUPSUnauthorizedCallContext();
                    /**
                     * @dev The storage `slot` is unsupported as a UUID.
                     */
                    error UUPSUnsupportedProxiableUUID(bytes32 slot);
                    /**
                     * @dev Check that the execution is being performed through a delegatecall call and that the execution context is
                     * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
                     * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
                     * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
                     * fail.
                     */
                    modifier onlyProxy() {
                        _checkProxy();
                        _;
                    }
                    /**
                     * @dev Check that the execution is not being performed through a delegate call. This allows a function to be
                     * callable on the implementing contract but not through proxies.
                     */
                    modifier notDelegated() {
                        _checkNotDelegated();
                        _;
                    }
                    function __UUPSUpgradeable_init() internal onlyInitializing {
                    }
                    function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
                    }
                    /**
                     * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
                     * implementation. It is used to validate the implementation's compatibility when performing an upgrade.
                     *
                     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
                     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
                     * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
                     */
                    function proxiableUUID() external view virtual notDelegated returns (bytes32) {
                        return ERC1967Utils.IMPLEMENTATION_SLOT;
                    }
                    /**
                     * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
                     * encoded in `data`.
                     *
                     * Calls {_authorizeUpgrade}.
                     *
                     * Emits an {Upgraded} event.
                     *
                     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall
                     */
                    function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
                        _authorizeUpgrade(newImplementation);
                        _upgradeToAndCallUUPS(newImplementation, data);
                    }
                    /**
                     * @dev Reverts if the execution is not performed via delegatecall or the execution
                     * context is not of a proxy with an ERC1967-compliant implementation pointing to self.
                     * See {_onlyProxy}.
                     */
                    function _checkProxy() internal view virtual {
                        if (
                            address(this) == __self || // Must be called through delegatecall
                            ERC1967Utils.getImplementation() != __self // Must be called through an active proxy
                        ) {
                            revert UUPSUnauthorizedCallContext();
                        }
                    }
                    /**
                     * @dev Reverts if the execution is performed via delegatecall.
                     * See {notDelegated}.
                     */
                    function _checkNotDelegated() internal view virtual {
                        if (address(this) != __self) {
                            // Must not be called through delegatecall
                            revert UUPSUnauthorizedCallContext();
                        }
                    }
                    /**
                     * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
                     * {upgradeToAndCall}.
                     *
                     * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
                     *
                     * ```solidity
                     * function _authorizeUpgrade(address) internal onlyOwner {}
                     * ```
                     */
                    function _authorizeUpgrade(address newImplementation) internal virtual;
                    /**
                     * @dev Performs an implementation upgrade with a security check for UUPS proxies, and additional setup call.
                     *
                     * As a security check, {proxiableUUID} is invoked in the new implementation, and the return value
                     * is expected to be the implementation slot in ERC1967.
                     *
                     * Emits an {IERC1967-Upgraded} event.
                     */
                    function _upgradeToAndCallUUPS(address newImplementation, bytes memory data) private {
                        try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                            if (slot != ERC1967Utils.IMPLEMENTATION_SLOT) {
                                revert UUPSUnsupportedProxiableUUID(slot);
                            }
                            ERC1967Utils.upgradeToAndCall(newImplementation, data);
                        } catch {
                            // The implementation is not UUPS
                            revert ERC1967Utils.ERC1967InvalidImplementation(newImplementation);
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC1822.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
                 * proxy whose upgrades are fully controlled by the current implementation.
                 */
                interface IERC1822Proxiable {
                    /**
                     * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
                     * address.
                     *
                     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
                     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
                     * function revert if invoked through a proxy.
                     */
                    function proxiableUUID() external view returns (bytes32);
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)
                pragma solidity ^0.8.20;
                import {IBeacon} from "../beacon/IBeacon.sol";
                import {Address} from "../../utils/Address.sol";
                import {StorageSlot} from "../../utils/StorageSlot.sol";
                /**
                 * @dev This abstract contract provides getters and event emitting update functions for
                 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
                 */
                library ERC1967Utils {
                    // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
                    // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
                    /**
                     * @dev Emitted when the implementation is upgraded.
                     */
                    event Upgraded(address indexed implementation);
                    /**
                     * @dev Emitted when the admin account has changed.
                     */
                    event AdminChanged(address previousAdmin, address newAdmin);
                    /**
                     * @dev Emitted when the beacon is changed.
                     */
                    event BeaconUpgraded(address indexed beacon);
                    /**
                     * @dev Storage slot with the address of the current implementation.
                     * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
                     */
                    // solhint-disable-next-line private-vars-leading-underscore
                    bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                    /**
                     * @dev The `implementation` of the proxy is invalid.
                     */
                    error ERC1967InvalidImplementation(address implementation);
                    /**
                     * @dev The `admin` of the proxy is invalid.
                     */
                    error ERC1967InvalidAdmin(address admin);
                    /**
                     * @dev The `beacon` of the proxy is invalid.
                     */
                    error ERC1967InvalidBeacon(address beacon);
                    /**
                     * @dev An upgrade function sees `msg.value > 0` that may be lost.
                     */
                    error ERC1967NonPayable();
                    /**
                     * @dev Returns the current implementation address.
                     */
                    function getImplementation() internal view returns (address) {
                        return StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value;
                    }
                    /**
                     * @dev Stores a new address in the EIP1967 implementation slot.
                     */
                    function _setImplementation(address newImplementation) private {
                        if (newImplementation.code.length == 0) {
                            revert ERC1967InvalidImplementation(newImplementation);
                        }
                        StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
                    }
                    /**
                     * @dev Performs implementation upgrade with additional setup call if data is nonempty.
                     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                     * to avoid stuck value in the contract.
                     *
                     * Emits an {IERC1967-Upgraded} event.
                     */
                    function upgradeToAndCall(address newImplementation, bytes memory data) internal {
                        _setImplementation(newImplementation);
                        emit Upgraded(newImplementation);
                        if (data.length > 0) {
                            Address.functionDelegateCall(newImplementation, data);
                        } else {
                            _checkNonPayable();
                        }
                    }
                    /**
                     * @dev Storage slot with the admin of the contract.
                     * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
                     */
                    // solhint-disable-next-line private-vars-leading-underscore
                    bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                    /**
                     * @dev Returns the current admin.
                     *
                     * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using
                     * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                     * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
                     */
                    function getAdmin() internal view returns (address) {
                        return StorageSlot.getAddressSlot(ADMIN_SLOT).value;
                    }
                    /**
                     * @dev Stores a new address in the EIP1967 admin slot.
                     */
                    function _setAdmin(address newAdmin) private {
                        if (newAdmin == address(0)) {
                            revert ERC1967InvalidAdmin(address(0));
                        }
                        StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
                    }
                    /**
                     * @dev Changes the admin of the proxy.
                     *
                     * Emits an {IERC1967-AdminChanged} event.
                     */
                    function changeAdmin(address newAdmin) internal {
                        emit AdminChanged(getAdmin(), newAdmin);
                        _setAdmin(newAdmin);
                    }
                    /**
                     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                     * This is the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
                     */
                    // solhint-disable-next-line private-vars-leading-underscore
                    bytes32 internal constant BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                    /**
                     * @dev Returns the current beacon.
                     */
                    function getBeacon() internal view returns (address) {
                        return StorageSlot.getAddressSlot(BEACON_SLOT).value;
                    }
                    /**
                     * @dev Stores a new beacon in the EIP1967 beacon slot.
                     */
                    function _setBeacon(address newBeacon) private {
                        if (newBeacon.code.length == 0) {
                            revert ERC1967InvalidBeacon(newBeacon);
                        }
                        StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;
                        address beaconImplementation = IBeacon(newBeacon).implementation();
                        if (beaconImplementation.code.length == 0) {
                            revert ERC1967InvalidImplementation(beaconImplementation);
                        }
                    }
                    /**
                     * @dev Change the beacon and trigger a setup call if data is nonempty.
                     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                     * to avoid stuck value in the contract.
                     *
                     * Emits an {IERC1967-BeaconUpgraded} event.
                     *
                     * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
                     * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
                     * efficiency.
                     */
                    function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
                        _setBeacon(newBeacon);
                        emit BeaconUpgraded(newBeacon);
                        if (data.length > 0) {
                            Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                        } else {
                            _checkNonPayable();
                        }
                    }
                    /**
                     * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
                     * if an upgrade doesn't perform an initialization call.
                     */
                    function _checkNonPayable() private {
                        if (msg.value > 0) {
                            revert ERC1967NonPayable();
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
                 * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
                 * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
                 * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
                 *
                 * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
                 * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
                 * case an upgrade adds a module that needs to be initialized.
                 *
                 * For example:
                 *
                 * [.hljs-theme-light.nopadding]
                 * ```solidity
                 * contract MyToken is ERC20Upgradeable {
                 *     function initialize() initializer public {
                 *         __ERC20_init("MyToken", "MTK");
                 *     }
                 * }
                 *
                 * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
                 *     function initializeV2() reinitializer(2) public {
                 *         __ERC20Permit_init("MyToken");
                 *     }
                 * }
                 * ```
                 *
                 * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
                 * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
                 *
                 * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
                 * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
                 *
                 * [CAUTION]
                 * ====
                 * Avoid leaving a contract uninitialized.
                 *
                 * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
                 * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
                 * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
                 *
                 * [.hljs-theme-light.nopadding]
                 * ```
                 * /// @custom:oz-upgrades-unsafe-allow constructor
                 * constructor() {
                 *     _disableInitializers();
                 * }
                 * ```
                 * ====
                 */
                abstract contract Initializable {
                    /**
                     * @dev Storage of the initializable contract.
                     *
                     * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions
                     * when using with upgradeable contracts.
                     *
                     * @custom:storage-location erc7201:openzeppelin.storage.Initializable
                     */
                    struct InitializableStorage {
                        /**
                         * @dev Indicates that the contract has been initialized.
                         */
                        uint64 _initialized;
                        /**
                         * @dev Indicates that the contract is in the process of being initialized.
                         */
                        bool _initializing;
                    }
                    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff))
                    bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;
                    /**
                     * @dev The contract is already initialized.
                     */
                    error InvalidInitialization();
                    /**
                     * @dev The contract is not initializing.
                     */
                    error NotInitializing();
                    /**
                     * @dev Triggered when the contract has been initialized or reinitialized.
                     */
                    event Initialized(uint64 version);
                    /**
                     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
                     * `onlyInitializing` functions can be used to initialize parent contracts.
                     *
                     * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any
                     * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in
                     * production.
                     *
                     * Emits an {Initialized} event.
                     */
                    modifier initializer() {
                        // solhint-disable-next-line var-name-mixedcase
                        InitializableStorage storage $ = _getInitializableStorage();
                        // Cache values to avoid duplicated sloads
                        bool isTopLevelCall = !$._initializing;
                        uint64 initialized = $._initialized;
                        // Allowed calls:
                        // - initialSetup: the contract is not in the initializing state and no previous version was
                        //                 initialized
                        // - construction: the contract is initialized at version 1 (no reininitialization) and the
                        //                 current contract is just being deployed
                        bool initialSetup = initialized == 0 && isTopLevelCall;
                        bool construction = initialized == 1 && address(this).code.length == 0;
                        if (!initialSetup && !construction) {
                            revert InvalidInitialization();
                        }
                        $._initialized = 1;
                        if (isTopLevelCall) {
                            $._initializing = true;
                        }
                        _;
                        if (isTopLevelCall) {
                            $._initializing = false;
                            emit Initialized(1);
                        }
                    }
                    /**
                     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
                     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
                     * used to initialize parent contracts.
                     *
                     * A reinitializer may be used after the original initialization step. This is essential to configure modules that
                     * are added through upgrades and that require initialization.
                     *
                     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
                     * cannot be nested. If one is invoked in the context of another, execution will revert.
                     *
                     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
                     * a contract, executing them in the right order is up to the developer or operator.
                     *
                     * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.
                     *
                     * Emits an {Initialized} event.
                     */
                    modifier reinitializer(uint64 version) {
                        // solhint-disable-next-line var-name-mixedcase
                        InitializableStorage storage $ = _getInitializableStorage();
                        if ($._initializing || $._initialized >= version) {
                            revert InvalidInitialization();
                        }
                        $._initialized = version;
                        $._initializing = true;
                        _;
                        $._initializing = false;
                        emit Initialized(version);
                    }
                    /**
                     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
                     * {initializer} and {reinitializer} modifiers, directly or indirectly.
                     */
                    modifier onlyInitializing() {
                        _checkInitializing();
                        _;
                    }
                    /**
                     * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.
                     */
                    function _checkInitializing() internal view virtual {
                        if (!_isInitializing()) {
                            revert NotInitializing();
                        }
                    }
                    /**
                     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
                     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
                     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
                     * through proxies.
                     *
                     * Emits an {Initialized} event the first time it is successfully executed.
                     */
                    function _disableInitializers() internal virtual {
                        // solhint-disable-next-line var-name-mixedcase
                        InitializableStorage storage $ = _getInitializableStorage();
                        if ($._initializing) {
                            revert InvalidInitialization();
                        }
                        if ($._initialized != type(uint64).max) {
                            $._initialized = type(uint64).max;
                            emit Initialized(type(uint64).max);
                        }
                    }
                    /**
                     * @dev Returns the highest version that has been initialized. See {reinitializer}.
                     */
                    function _getInitializedVersion() internal view returns (uint64) {
                        return _getInitializableStorage()._initialized;
                    }
                    /**
                     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
                     */
                    function _isInitializing() internal view returns (bool) {
                        return _getInitializableStorage()._initializing;
                    }
                    /**
                     * @dev Returns a pointer to the storage namespace.
                     */
                    // solhint-disable-next-line var-name-mixedcase
                    function _getInitializableStorage() private pure returns (InitializableStorage storage $) {
                        assembly {
                            $.slot := INITIALIZABLE_STORAGE
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev This is the interface that {BeaconProxy} expects of its beacon.
                 */
                interface IBeacon {
                    /**
                     * @dev Must return an address that can be used as a delegate call target.
                     *
                     * {UpgradeableBeacon} will check that this address is a contract.
                     */
                    function implementation() external view returns (address);
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
                pragma solidity ^0.8.20;
                /**
                 * @dev Collection of functions related to the address type
                 */
                library Address {
                    /**
                     * @dev The ETH balance of the account is not enough to perform the operation.
                     */
                    error AddressInsufficientBalance(address account);
                    /**
                     * @dev There's no code at `target` (it is not a contract).
                     */
                    error AddressEmptyCode(address target);
                    /**
                     * @dev A call to an address target failed. The target may have reverted.
                     */
                    error FailedInnerCall();
                    /**
                     * @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 AddressInsufficientBalance(address(this));
                        }
                        (bool success, ) = recipient.call{value: amount}("");
                        if (!success) {
                            revert FailedInnerCall();
                        }
                    }
                    /**
                     * @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
                     * {FailedInnerCall} 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 AddressInsufficientBalance(address(this));
                        }
                        (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 {FailedInnerCall}) 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 {FailedInnerCall} 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 {FailedInnerCall}.
                     */
                    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
                            /// @solidity memory-safe-assembly
                            assembly {
                                let returndata_size := mload(returndata)
                                revert(add(32, returndata), returndata_size)
                            }
                        } else {
                            revert FailedInnerCall();
                        }
                    }
                }
                // SPDX-License-Identifier: MIT
                // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
                // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
                pragma solidity ^0.8.20;
                /**
                 * @dev Library for reading and writing primitive types to specific storage slots.
                 *
                 * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
                 * This library helps with reading and writing to such slots without the need for inline assembly.
                 *
                 * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
                 *
                 * Example usage to set ERC1967 implementation slot:
                 * ```solidity
                 * contract ERC1967 {
                 *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                 *
                 *     function _getImplementation() internal view returns (address) {
                 *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
                 *     }
                 *
                 *     function _setImplementation(address newImplementation) internal {
                 *         require(newImplementation.code.length > 0);
                 *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
                 *     }
                 * }
                 * ```
                 */
                library StorageSlot {
                    struct AddressSlot {
                        address value;
                    }
                    struct BooleanSlot {
                        bool value;
                    }
                    struct Bytes32Slot {
                        bytes32 value;
                    }
                    struct Uint256Slot {
                        uint256 value;
                    }
                    struct StringSlot {
                        string value;
                    }
                    struct BytesSlot {
                        bytes value;
                    }
                    /**
                     * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                     */
                    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                     */
                    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                     */
                    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                     */
                    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `StringSlot` with member `value` located at `slot`.
                     */
                    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
                     */
                    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := store.slot
                        }
                    }
                    /**
                     * @dev Returns an `BytesSlot` with member `value` located at `slot`.
                     */
                    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := slot
                        }
                    }
                    /**
                     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
                     */
                    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                        /// @solidity memory-safe-assembly
                        assembly {
                            r.slot := store.slot
                        }
                    }
                }