{"file_path":"src/SUsds.sol","creation_status":"success","source_code":"// SPDX-License-Identifier: AGPL-3.0-or-later\n\n/// SUsds.sol\n\n// Copyright (C) 2017, 2018, 2019 dbrock, rain, mrchico\n// Copyright (C) 2021 Dai Foundation\n//\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU Affero General Public License as published by\n// the Free Software Foundation, either version 3 of the License, or\n// (at your option) any later version.\n//\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n// GNU Affero General Public License for more details.\n//\n// You should have received a copy of the GNU Affero General Public License\n// along with this program.  If not, see <https://www.gnu.org/licenses/>.\n\npragma solidity ^0.8.21;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\n\ninterface IERC1271 {\n    function isValidSignature(\n        bytes32,\n        bytes memory\n    ) external view returns (bytes4);\n}\n\ninterface VatLike {\n    function hope(address) external;\n    function suck(address, address, uint256) external;\n}\n\ninterface UsdsJoinLike {\n    function vat() external view returns (address);\n    function usds() external view returns (address);\n    function exit(address, uint256) external;\n}\n\ninterface UsdsLike {\n    function transfer(address, uint256) external;\n    function transferFrom(address, address, uint256) external;\n}\n\ncontract SUsds is UUPSUpgradeable {\n\n    // --- Storage Variables ---\n\n    // Admin\n    mapping (address => uint256) public wards;\n    // ERC20\n    uint256                                           public totalSupply;\n    mapping (address => uint256)                      public balanceOf;\n    mapping (address => mapping (address => uint256)) public allowance;\n    mapping (address => uint256)                      public nonces;\n    // Savings yield\n    uint192 public chi;   // The Rate Accumulator  [ray]\n    uint64  public rho;   // Time of last drip     [unix epoch time]\n    uint256 public ssr;   // The USDS Savings Rate [ray]\n\n    // --- Constants ---\n\n    // ERC20\n    string  public constant name     = \"Savings USDS\";\n    string  public constant symbol   = \"sUSDS\";\n    string  public constant version  = \"1\";\n    uint8   public constant decimals = 18;\n    // Math\n    uint256 private constant RAY = 10 ** 27;\n\n    // --- Immutables ---\n\n    // EIP712\n    bytes32 public constant PERMIT_TYPEHASH = keccak256(\"Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)\");\n    // Savings yield\n    UsdsJoinLike public immutable usdsJoin;\n    VatLike      public immutable vat;\n    UsdsLike     public immutable usds;\n    address      public immutable vow;\n\n    // --- Events ---\n\n    // Admin\n    event Rely(address indexed usr);\n    event Deny(address indexed usr);\n    event File(bytes32 indexed what, uint256 data);\n    // ERC20\n    event Approval(address indexed owner, address indexed spender, uint256 value);\n    event Transfer(address indexed from, address indexed to, uint256 value);\n    // ERC4626\n    event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares);\n    event Withdraw(address indexed sender, address indexed receiver, address indexed owner, uint256 assets, uint256 shares);\n    // Referral\n    event Referral(uint16 indexed referral, address indexed owner, uint256 assets, uint256 shares);\n    // Savings yield\n    event Drip(uint256 chi, uint256 diff);\n\n    // --- Modifiers ---\n\n    modifier auth {\n        require(wards[msg.sender] == 1, \"SUsds/not-authorized\");\n        _;\n    }\n\n    // --- Constructor ---\n\n    constructor(address usdsJoin_, address vow_) {\n        _disableInitializers(); // Avoid initializing in the context of the implementation\n\n        usdsJoin = UsdsJoinLike(usdsJoin_);\n        vat = VatLike(UsdsJoinLike(usdsJoin_).vat());\n        usds = UsdsLike(UsdsJoinLike(usdsJoin_).usds());\n        vow = vow_;\n    }\n\n    // --- Upgradability ---\n\n    function initialize() initializer external {\n        __UUPSUpgradeable_init();\n\n        chi = uint192(RAY);\n        rho = uint64(block.timestamp);\n        ssr = RAY;\n        vat.hope(address(usdsJoin));\n        wards[msg.sender] = 1;\n        emit Rely(msg.sender);\n    }\n\n    function _authorizeUpgrade(address newImplementation) internal override auth {}\n\n    function getImplementation() external view returns (address) {\n        return ERC1967Utils.getImplementation();\n    }\n\n    // --- Internals ---\n\n    // EIP712\n\n    function _calculateDomainSeparator(uint256 chainId) private view returns (bytes32) {\n        return keccak256(\n            abi.encode(\n                keccak256(\"EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)\"),\n                keccak256(bytes(name)),\n                keccak256(bytes(version)),\n                chainId,\n                address(this)\n            )\n        );\n    }\n\n    function DOMAIN_SEPARATOR() external view returns (bytes32) {\n        return _calculateDomainSeparator(block.chainid);\n    }\n\n    // Math\n\n    function _rpow(uint256 x, uint256 n) internal pure returns (uint256 z) {\n        assembly {\n            switch x case 0 {switch n case 0 {z := RAY} default {z := 0}}\n            default {\n                switch mod(n, 2) case 0 { z := RAY } default { z := x }\n                let half := div(RAY, 2)  // for rounding.\n                for { n := div(n, 2) } n { n := div(n,2) } {\n                    let xx := mul(x, x)\n                    if iszero(eq(div(xx, x), x)) { revert(0,0) }\n                    let xxRound := add(xx, half)\n                    if lt(xxRound, xx) { revert(0,0) }\n                    x := div(xxRound, RAY)\n                    if mod(n,2) {\n                        let zx := mul(z, x)\n                        if and(iszero(iszero(x)), iszero(eq(div(zx, x), z))) { revert(0,0) }\n                        let zxRound := add(zx, half)\n                        if lt(zxRound, zx) { revert(0,0) }\n                        z := div(zxRound, RAY)\n                    }\n                }\n            }\n        }\n    }\n\n    function _divup(uint256 x, uint256 y) internal pure returns (uint256 z) {\n        // Note: _divup(0,0) will return 0 differing from natural solidity division\n        unchecked {\n            z = x != 0 ? ((x - 1) / y) + 1 : 0;\n        }\n    }\n\n    // --- Admin external functions ---\n\n    function rely(address usr) external auth {\n        wards[usr] = 1;\n        emit Rely(usr);\n    }\n\n    function deny(address usr) external auth {\n        wards[usr] = 0;\n        emit Deny(usr);\n    }\n\n    function file(bytes32 what, uint256 data) external auth {\n        if (what == \"ssr\") {\n            require(data >= RAY, \"SUsds/wrong-ssr-value\");\n            require(rho == block.timestamp, \"SUsds/chi-not-up-to-date\");\n            ssr = data;\n        } else revert(\"SUsds/file-unrecognized-param\");\n        emit File(what, data);\n    }\n\n    // --- Savings Rate Accumulation external/internal function ---\n\n    function drip() public returns (uint256 nChi) {\n        (uint256 chi_, uint256 rho_) = (chi, rho);\n        uint256 diff;\n        if (block.timestamp > rho_) {\n            nChi = _rpow(ssr, block.timestamp - rho_) * chi_ / RAY;\n            uint256 totalSupply_ = totalSupply;\n            diff = totalSupply_ * nChi / RAY - totalSupply_ * chi_ / RAY;\n            vat.suck(address(vow), address(this), diff * RAY);\n            usdsJoin.exit(address(this), diff);\n            chi = uint192(nChi); // safe as nChi is limited to maxUint256/RAY (which is < maxUint192)\n            rho = uint64(block.timestamp);\n        } else {\n            nChi = chi_;\n        }\n        emit Drip(nChi, diff);\n    }\n\n    // --- ERC20 Mutations ---\n\n    function transfer(address to, uint256 value) external returns (bool) {\n        require(to != address(0) && to != address(this), \"SUsds/invalid-address\");\n        uint256 balance = balanceOf[msg.sender];\n        require(balance >= value, \"SUsds/insufficient-balance\");\n\n        unchecked {\n            balanceOf[msg.sender] = balance - value;\n            balanceOf[to] += value; // note: we don't need an overflow check here b/c sum of all balances == totalSupply\n        }\n\n        emit Transfer(msg.sender, to, value);\n\n        return true;\n    }\n\n    function transferFrom(address from, address to, uint256 value) external returns (bool) {\n        require(to != address(0) && to != address(this), \"SUsds/invalid-address\");\n        uint256 balance = balanceOf[from];\n        require(balance >= value, \"SUsds/insufficient-balance\");\n\n        if (from != msg.sender) {\n            uint256 allowed = allowance[from][msg.sender];\n            if (allowed != type(uint256).max) {\n                require(allowed >= value, \"SUsds/insufficient-allowance\");\n\n                unchecked {\n                    allowance[from][msg.sender] = allowed - value;\n                }\n            }\n        }\n\n        unchecked {\n            balanceOf[from] = balance - value;\n            balanceOf[to] += value; // note: we don't need an overflow check here b/c sum of all balances == totalSupply\n        }\n\n        emit Transfer(from, to, value);\n\n        return true;\n    }\n\n    function approve(address spender, uint256 value) external returns (bool) {\n        allowance[msg.sender][spender] = value;\n\n        emit Approval(msg.sender, spender, value);\n\n        return true;\n    }\n\n    // --- Mint/Burn Internal ---\n\n    function _mint(uint256 assets, uint256 shares, address receiver) internal {\n        require(receiver != address(0) && receiver != address(this), \"SUsds/invalid-address\");\n\n        usds.transferFrom(msg.sender, address(this), assets);\n\n        unchecked {\n            balanceOf[receiver] = balanceOf[receiver] + shares; // note: we don't need an overflow check here b/c balanceOf[receiver] <= totalSupply\n            totalSupply = totalSupply + shares; // note: we don't need an overflow check here b/c shares totalSupply will always be <= usds totalSupply\n        }\n\n        emit Deposit(msg.sender, receiver, assets, shares);\n        emit Transfer(address(0), receiver, shares);\n    }\n\n    function _burn(uint256 assets, uint256 shares, address receiver, address owner) internal {\n        uint256 balance = balanceOf[owner];\n        require(balance >= shares, \"SUsds/insufficient-balance\");\n\n        if (owner != msg.sender) {\n            uint256 allowed = allowance[owner][msg.sender];\n            if (allowed != type(uint256).max) {\n                require(allowed >= shares, \"SUsds/insufficient-allowance\");\n\n                unchecked {\n                    allowance[owner][msg.sender] = allowed - shares;\n                }\n            }\n        }\n\n        unchecked {\n            balanceOf[owner] = balance - shares; // note: we don't need overflow checks b/c require(balance >= shares) and balance <= totalSupply\n            totalSupply      = totalSupply - shares;\n        }\n\n        usds.transfer(receiver, assets);\n\n        emit Transfer(owner, address(0), shares);\n        emit Withdraw(msg.sender, receiver, owner, assets, shares);\n    }\n\n    // --- ERC-4626 ---\n\n    function asset() external view returns (address) {\n        return address(usds);\n    }\n\n    function totalAssets() external view returns (uint256) {\n        return convertToAssets(totalSupply);\n    }\n\n    function convertToShares(uint256 assets) public view returns (uint256) {\n        uint256 chi_ = (block.timestamp > rho) ? _rpow(ssr, block.timestamp - rho) * chi / RAY : chi;\n        return assets * RAY / chi_;\n    }\n\n    function convertToAssets(uint256 shares) public view returns (uint256) {\n        uint256 chi_ = (block.timestamp > rho) ? _rpow(ssr, block.timestamp - rho) * chi / RAY : chi;\n        return shares * chi_ / RAY;\n    }\n\n    function maxDeposit(address) external pure returns (uint256) {\n        return type(uint256).max;\n    }\n\n    function previewDeposit(uint256 assets) external view returns (uint256) {\n        return convertToShares(assets);\n    }\n\n    function deposit(uint256 assets, address receiver) public returns (uint256 shares) {\n        shares = assets * RAY / drip();\n        _mint(assets, shares, receiver);\n    }\n\n    function deposit(uint256 assets, address receiver, uint16 referral) external returns (uint256 shares) {\n        shares = deposit(assets, receiver);\n        emit Referral(referral, receiver, assets, shares);\n    }\n\n    function maxMint(address) external pure returns (uint256) {\n        return type(uint256).max;\n    }\n\n    function previewMint(uint256 shares) external view returns (uint256) {\n        uint256 chi_ = (block.timestamp > rho) ? _rpow(ssr, block.timestamp - rho) * chi / RAY : chi;\n        return _divup(shares * chi_, RAY);\n    }\n\n    function mint(uint256 shares, address receiver) public returns (uint256 assets) {\n        assets = _divup(shares * drip(), RAY);\n        _mint(assets, shares, receiver);\n    }\n\n    function mint(uint256 shares, address receiver, uint16 referral) external returns (uint256 assets) {\n        assets = mint(shares, receiver);\n        emit Referral(referral, receiver, assets, shares);\n    }\n\n    function maxWithdraw(address owner) external view returns (uint256) {\n        return convertToAssets(balanceOf[owner]);\n    }\n\n    function previewWithdraw(uint256 assets) external view returns (uint256) {\n        uint256 chi_ = (block.timestamp > rho) ? _rpow(ssr, block.timestamp - rho) * chi / RAY : chi;\n        return _divup(assets * RAY, chi_);\n    }\n\n    function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares) {\n        shares = _divup(assets * RAY, drip());\n        _burn(assets, shares, receiver, owner);\n    }\n\n    function maxRedeem(address owner) external view returns (uint256) {\n        return balanceOf[owner];\n    }\n\n    function previewRedeem(uint256 shares) external view returns (uint256) {\n        return convertToAssets(shares);\n    }\n\n    function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets) {\n        assets = shares * drip() / RAY;\n        _burn(assets, shares, receiver, owner);\n    }\n\n    // --- Approve by signature ---\n\n    function _isValidSignature(\n        address signer,\n        bytes32 digest,\n        bytes memory signature\n    ) internal view returns (bool valid) {\n        if (signature.length == 65) {\n            bytes32 r;\n            bytes32 s;\n            uint8 v;\n            assembly {\n                r := mload(add(signature, 0x20))\n                s := mload(add(signature, 0x40))\n                v := byte(0, mload(add(signature, 0x60)))\n            }\n            if (signer == ecrecover(digest, v, r, s)) {\n                return true;\n            }\n        }\n\n        if (signer.code.length > 0) {\n            (bool success, bytes memory result) = signer.staticcall(\n                abi.encodeCall(IERC1271.isValidSignature, (digest, signature))\n            );\n            valid = (success &&\n                result.length == 32 &&\n                abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector);\n        }\n    }\n\n    function permit(\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        bytes memory signature\n    ) public {\n        require(block.timestamp <= deadline, \"SUsds/permit-expired\");\n        require(owner != address(0), \"SUsds/invalid-owner\");\n\n        uint256 nonce;\n        unchecked { nonce = nonces[owner]++; }\n\n        bytes32 digest =\n            keccak256(abi.encodePacked(\n                \"\\x19\\x01\",\n                _calculateDomainSeparator(block.chainid),\n                keccak256(abi.encode(\n                    PERMIT_TYPEHASH,\n                    owner,\n                    spender,\n                    value,\n                    nonce,\n                    deadline\n                ))\n            ));\n\n        require(_isValidSignature(owner, digest, signature), \"SUsds/invalid-permit\");\n\n        allowance[owner][spender] = value;\n        emit Approval(owner, spender, value);\n    }\n\n    function permit(\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) external {\n        permit(owner, spender, value, deadline, abi.encodePacked(r, s, v));\n    }\n}\n","deployed_bytecode":"0x6080604052600436106102c95760003560e01c806370a0823111610175578063b3d7f6b9116100dc578063c92aecc411610095578063d905777e1161006f578063d905777e14610966578063dd62ed3e1461099c578063ef8b30f7146109d4578063fa1e2e86146109f457600080fd5b8063c92aecc4146108ee578063ce96cb7714610926578063d505accf1461094657600080fd5b8063b3d7f6b914610841578063b460af9414610861578063ba08765214610881578063bf353dbb146108a1578063c63d75b614610567578063c6e6f592146108ce57600080fd5b80639c52a7f11161012e5780639c52a7f1146107865780639f678cca146107a65780639fd5a6cf146107bb578063a9059cbb146107db578063aaf10f42146107fb578063ad3cb1cc1461081057600080fd5b806370a08231146106a65780637ecebe00146106d35780638129fc1c1461070057806394bf804d1461071557806395d89b41146107355780639b8d6d381461076657600080fd5b8063313ce567116102345780634cf282fb116101ed57806354fd4d50116101c757806354fd4d5014610605578063626cb3c51461063257806365fae35e146106665780636e553f651461068657600080fd5b80634cf282fb146105a95780634f1ef286146105dd57806352d1902d146105f057600080fd5b8063313ce567146104ac5780633644e515146104d357806336569e77146104e857806338d52e0f14610534578063402d267d146105675780634cdad5061461058957600080fd5b806318160ddd1161028657806318160ddd146103c157806320aba08b146103d7578063216740a01461041657806323b872dd1461043657806329ae81141461045657806330adf81f1461047857600080fd5b806301e1d114146102ce57806303607ceb146102f657806306fdde031461030c57806307a2d13a14610351578063095ea7b3146103715780630a28a477146103a1575b600080fd5b3480156102da57600080fd5b506102e3610a28565b6040519081526020015b60405180910390f35b34801561030257600080fd5b506102e360065481565b34801561031857600080fd5b506103446040518060400160405280600c81526020016b536176696e6773205553445360a01b81525081565b6040516102ed9190612646565b34801561035d57600080fd5b506102e361036c366004612659565b610a3a565b34801561037d57600080fd5b5061039161038c36600461268e565b610ae7565b60405190151581526020016102ed565b3480156103ad57600080fd5b506102e36103bc366004612659565b610b54565b3480156103cd57600080fd5b506102e360015481565b3480156103e357600080fd5b506005546103fe90600160c01b90046001600160401b031681565b6040516001600160401b0390911681526020016102ed565b34801561042257600080fd5b506102e36104313660046126b8565b610bf3565b34801561044257600080fd5b506103916104513660046126ff565b610c59565b34801561046257600080fd5b5061047661047136600461273b565b610df3565b005b34801561048457600080fd5b506102e37f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c981565b3480156104b857600080fd5b506104c1601281565b60405160ff90911681526020016102ed565b3480156104df57600080fd5b506102e3610f74565b3480156104f457600080fd5b5061051c7f00000000000000000000000035d1b3f3d7966a1dfe207aa4514c12a259a0492b81565b6040516001600160a01b0390911681526020016102ed565b34801561054057600080fd5b507f000000000000000000000000dc035d45d973e3ec169d2276ddab16f1e407384f61051c565b34801561057357600080fd5b506102e361058236600461275d565b5060001990565b34801561059557600080fd5b506102e36105a4366004612659565b610f7f565b3480156105b557600080fd5b5061051c7f000000000000000000000000dc035d45d973e3ec169d2276ddab16f1e407384f81565b6104766105eb36600461281a565b610f8a565b3480156105fc57600080fd5b506102e3610fa9565b34801561061157600080fd5b50610344604051806040016040528060018152602001603160f81b81525081565b34801561063e57600080fd5b5061051c7f000000000000000000000000a950524441892a31ebddf91d3ceefa04bf45446681565b34801561067257600080fd5b5061047661068136600461275d565b610fc6565b34801561069257600080fd5b506102e36106a1366004612867565b61103a565b3480156106b257600080fd5b506102e36106c136600461275d565b60026020526000908152604090205481565b3480156106df57600080fd5b506102e36106ee36600461275d565b60046020526000908152604090205481565b34801561070c57600080fd5b50610476611070565b34801561072157600080fd5b506102e3610730366004612867565b611277565b34801561074157600080fd5b5061034460405180604001604052806005815260200164735553445360d81b81525081565b34801561077257600080fd5b506102e36107813660046126b8565b6112ac565b34801561079257600080fd5b506104766107a136600461275d565b611303565b3480156107b257600080fd5b506102e3611376565b3480156107c757600080fd5b506104766107d6366004612893565b6115d9565b3480156107e757600080fd5b506103916107f636600461268e565b6117fb565b34801561080757600080fd5b5061051c6118c2565b34801561081c57600080fd5b50610344604051806040016040528060058152602001640352e302e360dc1b81525081565b34801561084d57600080fd5b506102e361085c366004612659565b6118e3565b34801561086d57600080fd5b506102e361087c366004612904565b611971565b34801561088d57600080fd5b506102e361089c366004612904565b6119a6565b3480156108ad57600080fd5b506102e36108bc36600461275d565b60006020819052908152604090205481565b3480156108da57600080fd5b506102e36108e9366004612659565b6119de565b3480156108fa57600080fd5b5060055461090e906001600160c01b031681565b6040516001600160c01b0390911681526020016102ed565b34801561093257600080fd5b506102e361094136600461275d565b611a75565b34801561095257600080fd5b50610476610961366004612940565b611a97565b34801561097257600080fd5b506102e361098136600461275d565b6001600160a01b031660009081526002602052604090205490565b3480156109a857600080fd5b506102e36109b73660046129b3565b600360209081526000928352604080842090915290825290205481565b3480156109e057600080fd5b506102e36109ef366004612659565b611aee565b348015610a0057600080fd5b5061051c7f0000000000000000000000003c0f895007ca717aa01c8693e59df1e8c3777feb81565b6000610a35600154610a3a565b905090565b6005546000908190600160c01b90046001600160401b03164211610a69576005546001600160c01b0316610abe565b600554600654676765c793fa10079d601b1b916001600160c01b03811691610aaa91610aa590600160c01b90046001600160401b0316426129f3565b611af9565b610ab49190612a06565b610abe9190612a33565b9050676765c793fa10079d601b1b610ad68285612a06565b610ae09190612a33565b9392505050565b3360008181526003602090815260408083206001600160a01b038716808552925280832085905551919290917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92590610b429086815260200190565b60405180910390a35060015b92915050565b6005546000908190600160c01b90046001600160401b03164211610b83576005546001600160c01b0316610bd3565b600554600654676765c793fa10079d601b1b916001600160c01b03811691610bbf91610aa590600160c01b90046001600160401b0316426129f3565b610bc99190612a06565b610bd39190612a33565b9050610ae0610bed676765c793fa10079d601b1b85612a06565b82611beb565b6000610bff8484611277565b9050826001600160a01b03168261ffff167fb30a03a0e2a407f18ae0e83491331dc069d1521e292feffb071e61c8f7f406368387604051610c4a929190918252602082015260400190565b60405180910390a39392505050565b60006001600160a01b03831615801590610c7c57506001600160a01b0383163014155b610ca15760405162461bcd60e51b8152600401610c9890612a55565b60405180910390fd5b6001600160a01b03841660009081526002602052604090205482811015610cda5760405162461bcd60e51b8152600401610c9890612a84565b6001600160a01b0385163314610d92576001600160a01b03851660009081526003602090815260408083203384529091529020546000198114610d905783811015610d675760405162461bcd60e51b815260206004820152601c60248201527f53557364732f696e73756666696369656e742d616c6c6f77616e6365000000006044820152606401610c98565b6001600160a01b0386166000908152600360209081526040808320338452909152902084820390555b505b6001600160a01b038086166000818152600260205260408082208786039055928716808252908390208054870190559151600080516020612b8a83398151915290610de09087815260200190565b60405180910390a3506001949350505050565b33600090815260208190526040902054600114610e225760405162461bcd60e51b8152600401610c9890612abb565b816239b9b960e91b03610eee57676765c793fa10079d601b1b811015610e825760405162461bcd60e51b815260206004820152601560248201527453557364732f77726f6e672d7373722d76616c756560581b6044820152606401610c98565b6005546001600160401b03600160c01b909104164214610ee45760405162461bcd60e51b815260206004820152601860248201527f53557364732f6368692d6e6f742d75702d746f2d6461746500000000000000006044820152606401610c98565b6006819055610f36565b60405162461bcd60e51b815260206004820152601d60248201527f53557364732f66696c652d756e7265636f676e697a65642d706172616d0000006044820152606401610c98565b817fe986e40cc8c151830d4f61050f4fb2e4add8567caad2d5f5496f9158e91fe4c782604051610f6891815260200190565b60405180910390a25050565b6000610a3546611c19565b6000610b4e82610a3a565b610f92611cee565b610f9b82611d95565b610fa58282611dc7565b5050565b6000610fb3611e89565b50600080516020612b6a83398151915290565b33600090815260208190526040902054600114610ff55760405162461bcd60e51b8152600401610c9890612abb565b6001600160a01b03811660008181526020819052604080822060019055517fdd0e34038ac38b2a1ce960229778ac48a8719bc900b6c4f8d0475c6e8b385a609190a250565b6000611044611376565b611059676765c793fa10079d601b1b85612a06565b6110639190612a33565b9050610b4e838284611ed2565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff1615906001600160401b03166000811580156110b55750825b90506000826001600160401b031660011480156110d15750303b155b9050811580156110df575080155b156110fd5760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff19166001178555831561112757845460ff60401b1916600160401b1785555b61112f61202b565b676765c793fa10079d601b1b600160c01b426001600160401b03160281176005556006556040516328ec8bf160e21b81527f0000000000000000000000003c0f895007ca717aa01c8693e59df1e8c3777feb6001600160a01b0390811660048301527f00000000000000000000000035d1b3f3d7966a1dfe207aa4514c12a259a0492b169063a3b22fc490602401600060405180830381600087803b1580156111d757600080fd5b505af11580156111eb573d6000803e3d6000fd5b50503360008181526020819052604080822060019055519193507fdd0e34038ac38b2a1ce960229778ac48a8719bc900b6c4f8d0475c6e8b385a60925090a2831561127057845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050565b600061129f611284611376565b61128e9085612a06565b676765c793fa10079d601b1b611beb565b9050610b4e818484611ed2565b60006112b8848461103a565b9050826001600160a01b03168261ffff167fb30a03a0e2a407f18ae0e83491331dc069d1521e292feffb071e61c8f7f406368684604051610c4a929190918252602082015260400190565b336000908152602081905260409020546001146113325760405162461bcd60e51b8152600401610c9890612abb565b6001600160a01b038116600081815260208190526040808220829055517f184450df2e323acec0ed3b5c7531b81f9b4cdef7914dfd4c0a4317416bb5251b9190a250565b6005546000906001600160c01b03811690600160c01b90046001600160401b0316824282101561159657676765c793fa10079d601b1b836113bf6006548542610aa591906129f3565b6113c99190612a06565b6113d39190612a33565b600154909450676765c793fa10079d601b1b6113ef8583612a06565b6113f99190612a33565b676765c793fa10079d601b1b61140f8784612a06565b6114199190612a33565b61142391906129f3565b91506001600160a01b037f00000000000000000000000035d1b3f3d7966a1dfe207aa4514c12a259a0492b1663f24e23eb7f000000000000000000000000a950524441892a31ebddf91d3ceefa04bf4544663061148b676765c793fa10079d601b1b87612a06565b6040516001600160e01b031960e086901b1681526001600160a01b0393841660048201529290911660248301526044820152606401600060405180830381600087803b1580156114da57600080fd5b505af11580156114ee573d6000803e3d6000fd5b505060405163ef693bed60e01b8152306004820152602481018590527f0000000000000000000000003c0f895007ca717aa01c8693e59df1e8c3777feb6001600160a01b0316925063ef693bed9150604401600060405180830381600087803b15801561155a57600080fd5b505af115801561156e573d6000803e3d6000fd5b50505050506001600160401b034216600160c01b026001600160c01b0385161760055561159a565b8293505b60408051858152602081018390527fad1e8a53178522eb68a9d94d862bf30c841f709d2115f743eb6b34528751c79f910160405180910390a150505090565b814211156116205760405162461bcd60e51b815260206004820152601460248201527314d55cd91ccbdc195c9b5a5d0b595e1c1a5c995960621b6044820152606401610c98565b6001600160a01b03851661166c5760405162461bcd60e51b815260206004820152601360248201527229aab9b23997b4b73b30b634b216b7bbb732b960691b6044820152606401610c98565b6001600160a01b03851660009081526004602052604081208054600181019091559061169746611c19565b604080517f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c960208201526001600160a01b03808b169282019290925290881660608201526080810187905260a0810184905260c0810186905260e0016040516020818303038152906040528051906020012060405160200161173092919061190160f01b81526002810192909252602282015260420190565b604051602081830303815290604052805190602001209050611753878285612033565b6117965760405162461bcd60e51b815260206004820152601460248201527314d55cd91ccbda5b9d985b1a590b5c195c9b5a5d60621b6044820152606401610c98565b6001600160a01b038781166000818152600360209081526040808320948b168084529482529182902089905590518881527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a350505050505050565b60006001600160a01b0383161580159061181e57506001600160a01b0383163014155b61183a5760405162461bcd60e51b8152600401610c9890612a55565b336000908152600260205260409020548281101561186a5760405162461bcd60e51b8152600401610c9890612a84565b33600081815260026020908152604080832087860390556001600160a01b0388168084529281902080548801905551868152919291600080516020612b8a833981519152910160405180910390a35060019392505050565b6000610a35600080516020612b6a833981519152546001600160a01b031690565b6005546000908190600160c01b90046001600160401b03164211611912576005546001600160c01b0316611962565b600554600654676765c793fa10079d601b1b916001600160c01b0381169161194e91610aa590600160c01b90046001600160401b0316426129f3565b6119589190612a06565b6119629190612a33565b9050610ae061128e8285612a06565b600061199861198b676765c793fa10079d601b1b86612a06565b611993611376565b611beb565b9050610ae0848285856121c3565b6000676765c793fa10079d601b1b6119bc611376565b6119c69086612a06565b6119d09190612a33565b9050610ae0818585856121c3565b6005546000908190600160c01b90046001600160401b03164211611a0d576005546001600160c01b0316611a5d565b600554600654676765c793fa10079d601b1b916001600160c01b03811691611a4991610aa590600160c01b90046001600160401b0316426129f3565b611a539190612a06565b611a5d9190612a33565b905080610ad6676765c793fa10079d601b1b85612a06565b6001600160a01b038116600090815260026020526040812054610b4e90610a3a565b611ae587878787868689604051602001611ad193929190928352602083019190915260f81b6001600160f81b031916604082015260410190565b6040516020818303038152906040526115d9565b50505050505050565b6000610b4e826119de565b6000828015611bc357600183168015611b1457849250611b23565b676765c793fa10079d601b1b92505b506002909204916b019d971e4fe8401e740000005b8315611bbd578485028586820414611b4f57600080fd5b81810181811015611b5f57600080fd5b676765c793fa10079d601b1b90049550506001841615611bb2578483028386820414158615151615611b9057600080fd5b81810181811015611ba057600080fd5b676765c793fa10079d601b1b90049350505b600284049350611b38565b50611be4565b828015611bd35760009250611be2565b676765c793fa10079d601b1b92505b505b5092915050565b600082600003611bfc576000610ae0565b816001840381611c0e57611c0e612a1d565b046001019392505050565b604080518082018252600c81526b536176696e6773205553445360a01b6020918201528151808301835260018152603160f81b9082015281517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f818301527f7b833ce3d9e5473168246d98a161bea2c6ea238198d3a0a9e9edb9c1eb00b9f9818401527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc6606082015260808101939093523060a0808501919091528251808503909101815260c0909301909152815191012090565b306001600160a01b037f0000000000000000000000004e7991e5c547ce825bdeb665ee14a3274f9f61e0161480611d7557507f0000000000000000000000004e7991e5c547ce825bdeb665ee14a3274f9f61e06001600160a01b0316611d69600080516020612b6a833981519152546001600160a01b031690565b6001600160a01b031614155b15611d935760405163703e46dd60e11b815260040160405180910390fd5b565b33600090815260208190526040902054600114611dc45760405162461bcd60e51b8152600401610c9890612abb565b50565b816001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015611e21575060408051601f3d908101601f19168201909252611e1e91810190612ae9565b60015b611e4957604051634c9c8ce360e01b81526001600160a01b0383166004820152602401610c98565b600080516020612b6a8339815191528114611e7a57604051632a87526960e21b815260048101829052602401610c98565b611e8483836123d8565b505050565b306001600160a01b037f0000000000000000000000004e7991e5c547ce825bdeb665ee14a3274f9f61e01614611d935760405163703e46dd60e11b815260040160405180910390fd5b6001600160a01b03811615801590611ef357506001600160a01b0381163014155b611f0f5760405162461bcd60e51b8152600401610c9890612a55565b6040516323b872dd60e01b8152336004820152306024820152604481018490527f000000000000000000000000dc035d45d973e3ec169d2276ddab16f1e407384f6001600160a01b0316906323b872dd90606401600060405180830381600087803b158015611f7d57600080fd5b505af1158015611f91573d6000803e3d6000fd5b505050506001600160a01b0381166000818152600260209081526040918290208054860190556001805486019055815186815290810185905233917fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d7910160405180910390a36040518281526001600160a01b03821690600090600080516020612b8a8339815191529060200160405180910390a3505050565b611d9361242e565b600081516041036120d057602082810151604080850151606080870151835160008082529681018086528a9052951a928501839052840183905260808401819052919260019060a0016020604051602081039080840390855afa15801561209e573d6000803e3d6000fd5b505050602060405103516001600160a01b0316876001600160a01b0316036120cc5760019350505050610ae0565b5050505b6001600160a01b0384163b15610ae057600080856001600160a01b03168585604051602401612100929190612b02565b60408051601f198184030181529181526020820180516001600160e01b0316630b135d3f60e11b179052516121359190612b23565b600060405180830381855afa9150503d8060008114612170576040519150601f19603f3d011682016040523d82523d6000602084013e612175565b606091505b5091509150818015612188575080516020145b80156121b957508051630b135d3f60e11b906121ad9083016020908101908401612b3f565b6001600160e01b031916145b9695505050505050565b6001600160a01b038116600090815260026020526040902054838110156121fc5760405162461bcd60e51b8152600401610c9890612a84565b6001600160a01b03821633146122b4576001600160a01b038216600090815260036020908152604080832033845290915290205460001981146122b257848110156122895760405162461bcd60e51b815260206004820152601c60248201527f53557364732f696e73756666696369656e742d616c6c6f77616e6365000000006044820152606401610c98565b6001600160a01b0383166000908152600360209081526040808320338452909152902085820390555b505b6001600160a01b038281166000908152600260205260409081902086840390556001805487900390555163a9059cbb60e01b81528482166004820152602481018790527f000000000000000000000000dc035d45d973e3ec169d2276ddab16f1e407384f9091169063a9059cbb90604401600060405180830381600087803b15801561233f57600080fd5b505af1158015612353573d6000803e3d6000fd5b5050604051868152600092506001600160a01b0385169150600080516020612b8a8339815191529060200160405180910390a360408051868152602081018690526001600160a01b03808516929086169133917ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db910160405180910390a45050505050565b6123e182612477565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a280511561242657611e8482826124dc565b610fa5612552565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff16611d9357604051631afcd79f60e31b815260040160405180910390fd5b806001600160a01b03163b6000036124ad57604051634c9c8ce360e01b81526001600160a01b0382166004820152602401610c98565b600080516020612b6a83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6060600080846001600160a01b0316846040516124f99190612b23565b600060405180830381855af49150503d8060008114612534576040519150601f19603f3d011682016040523d82523d6000602084013e612539565b606091505b5091509150612549858383612571565b95945050505050565b3415611d935760405163b398979f60e01b815260040160405180910390fd5b60608261258657612581826125cd565b610ae0565b815115801561259d57506001600160a01b0384163b155b156125c657604051639996b31560e01b81526001600160a01b0385166004820152602401610c98565b5080610ae0565b8051156125dd5780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b60005b838110156126115781810151838201526020016125f9565b50506000910152565b600081518084526126328160208601602086016125f6565b601f01601f19169290920160200192915050565b602081526000610ae0602083018461261a565b60006020828403121561266b57600080fd5b5035919050565b80356001600160a01b038116811461268957600080fd5b919050565b600080604083850312156126a157600080fd5b6126aa83612672565b946020939093013593505050565b6000806000606084860312156126cd57600080fd5b833592506126dd60208501612672565b9150604084013561ffff811681146126f457600080fd5b809150509250925092565b60008060006060848603121561271457600080fd5b61271d84612672565b925061272b60208501612672565b9150604084013590509250925092565b6000806040838503121561274e57600080fd5b50508035926020909101359150565b60006020828403121561276f57600080fd5b610ae082612672565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261279f57600080fd5b81356001600160401b03808211156127b9576127b9612778565b604051601f8301601f19908116603f011681019082821181831017156127e1576127e1612778565b816040528381528660208588010111156127fa57600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806040838503121561282d57600080fd5b61283683612672565b915060208301356001600160401b0381111561285157600080fd5b61285d8582860161278e565b9150509250929050565b6000806040838503121561287a57600080fd5b8235915061288a60208401612672565b90509250929050565b600080600080600060a086880312156128ab57600080fd5b6128b486612672565b94506128c260208701612672565b9350604086013592506060860135915060808601356001600160401b038111156128eb57600080fd5b6128f78882890161278e565b9150509295509295909350565b60008060006060848603121561291957600080fd5b8335925061292960208501612672565b915061293760408501612672565b90509250925092565b600080600080600080600060e0888a03121561295b57600080fd5b61296488612672565b965061297260208901612672565b95506040880135945060608801359350608088013560ff8116811461299657600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156129c657600080fd5b6129cf83612672565b915061288a60208401612672565b634e487b7160e01b600052601160045260246000fd5b81810381811115610b4e57610b4e6129dd565b8082028115828204841417610b4e57610b4e6129dd565b634e487b7160e01b600052601260045260246000fd5b600082612a5057634e487b7160e01b600052601260045260246000fd5b500490565b60208082526015908201527453557364732f696e76616c69642d6164647265737360581b604082015260600190565b6020808252601a908201527f53557364732f696e73756666696369656e742d62616c616e6365000000000000604082015260600190565b60208082526014908201527314d55cd91ccbdb9bdd0b585d5d1a1bdc9a5e995960621b604082015260600190565b600060208284031215612afb57600080fd5b5051919050565b828152604060208201526000612b1b604083018461261a565b949350505050565b60008251612b358184602087016125f6565b9190910192915050565b600060208284031215612b5157600080fd5b81516001600160e01b031981168114610ae057600080fdfe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbcddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220efe51b4da684074b634b858f100541c75822df39c037f225ba038ffe08b7c09d64736f6c63430008150033","optimization_enabled":true,"verified_twin_address_hash":null,"is_verified":true,"compiler_settings":{"evmVersion":"paris","libraries":{},"metadata":{"bytecodeHash":"ipfs"},"optimizer":{"enabled":true,"runs":200},"remappings":[":@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/",":@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/",":openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/",":openzeppelin-contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/"]},"optimization_runs":200,"sourcify_repo_url":"https://repo.sourcify.dev/contracts/partial_match/1/0x4e7991e5C547ce825BdEb665EE14a3274f9F61e0/","decoded_constructor_args":[["0x3C0f895007CA717Aa01c8693e59DF1e8C3777FEB",{"internalType":"address","name":"usdsJoin_","type":"address"}],["0xA950524441892A31ebddF91d3cEEFa04Bf454466",{"internalType":"address","name":"vow_","type":"address"}]],"compiler_version":"0.8.21+commit.d9974bed","is_verified_via_verifier_alliance":false,"verified_at":"2024-09-17T12:01:10.010547Z","implementations":[],"proxy_type":null,"external_libraries":[],"creation_bytecode":"0x610120604052306080523480156200001657600080fd5b5060405162002ee438038062002ee483398101604081905262000039916200021d565b620000436200014c565b6001600160a01b03821660a0819052604080516336569e7760e01b815290516336569e77916004808201926020929091908290030181865afa1580156200008e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620000b4919062000255565b6001600160a01b031660c0816001600160a01b031681525050816001600160a01b0316634cf282fb6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156200010c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000132919062000255565b6001600160a01b0390811660e0521661010052506200027a565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff16156200019d5760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b0390811614620001fd5780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b80516001600160a01b03811681146200021857600080fd5b919050565b600080604083850312156200023157600080fd5b6200023c8362000200565b91506200024c6020840162000200565b90509250929050565b6000602082840312156200026857600080fd5b620002738262000200565b9392505050565b60805160a05160c05160e05161010051612bdf62000305600039600081816106440152611456015260008181610543015281816105bb01528181611f3101526122f90152600081816104fa01528181611193015261142f015260008181610a0601528181611162015261150c015260008181611cf901528181611d220152611e940152612bdf6000f3fe6080604052600436106102c95760003560e01c806370a0823111610175578063b3d7f6b9116100dc578063c92aecc411610095578063d905777e1161006f578063d905777e14610966578063dd62ed3e1461099c578063ef8b30f7146109d4578063fa1e2e86146109f457600080fd5b8063c92aecc4146108ee578063ce96cb7714610926578063d505accf1461094657600080fd5b8063b3d7f6b914610841578063b460af9414610861578063ba08765214610881578063bf353dbb146108a1578063c63d75b614610567578063c6e6f592146108ce57600080fd5b80639c52a7f11161012e5780639c52a7f1146107865780639f678cca146107a65780639fd5a6cf146107bb578063a9059cbb146107db578063aaf10f42146107fb578063ad3cb1cc1461081057600080fd5b806370a08231146106a65780637ecebe00146106d35780638129fc1c1461070057806394bf804d1461071557806395d89b41146107355780639b8d6d381461076657600080fd5b8063313ce567116102345780634cf282fb116101ed57806354fd4d50116101c757806354fd4d5014610605578063626cb3c51461063257806365fae35e146106665780636e553f651461068657600080fd5b80634cf282fb146105a95780634f1ef286146105dd57806352d1902d146105f057600080fd5b8063313ce567146104ac5780633644e515146104d357806336569e77146104e857806338d52e0f14610534578063402d267d146105675780634cdad5061461058957600080fd5b806318160ddd1161028657806318160ddd146103c157806320aba08b146103d7578063216740a01461041657806323b872dd1461043657806329ae81141461045657806330adf81f1461047857600080fd5b806301e1d114146102ce57806303607ceb146102f657806306fdde031461030c57806307a2d13a14610351578063095ea7b3146103715780630a28a477146103a1575b600080fd5b3480156102da57600080fd5b506102e3610a28565b6040519081526020015b60405180910390f35b34801561030257600080fd5b506102e360065481565b34801561031857600080fd5b506103446040518060400160405280600c81526020016b536176696e6773205553445360a01b81525081565b6040516102ed9190612646565b34801561035d57600080fd5b506102e361036c366004612659565b610a3a565b34801561037d57600080fd5b5061039161038c36600461268e565b610ae7565b60405190151581526020016102ed565b3480156103ad57600080fd5b506102e36103bc366004612659565b610b54565b3480156103cd57600080fd5b506102e360015481565b3480156103e357600080fd5b506005546103fe90600160c01b90046001600160401b031681565b6040516001600160401b0390911681526020016102ed565b34801561042257600080fd5b506102e36104313660046126b8565b610bf3565b34801561044257600080fd5b506103916104513660046126ff565b610c59565b34801561046257600080fd5b5061047661047136600461273b565b610df3565b005b34801561048457600080fd5b506102e37f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c981565b3480156104b857600080fd5b506104c1601281565b60405160ff90911681526020016102ed565b3480156104df57600080fd5b506102e3610f74565b3480156104f457600080fd5b5061051c7f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b0390911681526020016102ed565b34801561054057600080fd5b507f000000000000000000000000000000000000000000000000000000000000000061051c565b34801561057357600080fd5b506102e361058236600461275d565b5060001990565b34801561059557600080fd5b506102e36105a4366004612659565b610f7f565b3480156105b557600080fd5b5061051c7f000000000000000000000000000000000000000000000000000000000000000081565b6104766105eb36600461281a565b610f8a565b3480156105fc57600080fd5b506102e3610fa9565b34801561061157600080fd5b50610344604051806040016040528060018152602001603160f81b81525081565b34801561063e57600080fd5b5061051c7f000000000000000000000000000000000000000000000000000000000000000081565b34801561067257600080fd5b5061047661068136600461275d565b610fc6565b34801561069257600080fd5b506102e36106a1366004612867565b61103a565b3480156106b257600080fd5b506102e36106c136600461275d565b60026020526000908152604090205481565b3480156106df57600080fd5b506102e36106ee36600461275d565b60046020526000908152604090205481565b34801561070c57600080fd5b50610476611070565b34801561072157600080fd5b506102e3610730366004612867565b611277565b34801561074157600080fd5b5061034460405180604001604052806005815260200164735553445360d81b81525081565b34801561077257600080fd5b506102e36107813660046126b8565b6112ac565b34801561079257600080fd5b506104766107a136600461275d565b611303565b3480156107b257600080fd5b506102e3611376565b3480156107c757600080fd5b506104766107d6366004612893565b6115d9565b3480156107e757600080fd5b506103916107f636600461268e565b6117fb565b34801561080757600080fd5b5061051c6118c2565b34801561081c57600080fd5b50610344604051806040016040528060058152602001640352e302e360dc1b81525081565b34801561084d57600080fd5b506102e361085c366004612659565b6118e3565b34801561086d57600080fd5b506102e361087c366004612904565b611971565b34801561088d57600080fd5b506102e361089c366004612904565b6119a6565b3480156108ad57600080fd5b506102e36108bc36600461275d565b60006020819052908152604090205481565b3480156108da57600080fd5b506102e36108e9366004612659565b6119de565b3480156108fa57600080fd5b5060055461090e906001600160c01b031681565b6040516001600160c01b0390911681526020016102ed565b34801561093257600080fd5b506102e361094136600461275d565b611a75565b34801561095257600080fd5b50610476610961366004612940565b611a97565b34801561097257600080fd5b506102e361098136600461275d565b6001600160a01b031660009081526002602052604090205490565b3480156109a857600080fd5b506102e36109b73660046129b3565b600360209081526000928352604080842090915290825290205481565b3480156109e057600080fd5b506102e36109ef366004612659565b611aee565b348015610a0057600080fd5b5061051c7f000000000000000000000000000000000000000000000000000000000000000081565b6000610a35600154610a3a565b905090565b6005546000908190600160c01b90046001600160401b03164211610a69576005546001600160c01b0316610abe565b600554600654676765c793fa10079d601b1b916001600160c01b03811691610aaa91610aa590600160c01b90046001600160401b0316426129f3565b611af9565b610ab49190612a06565b610abe9190612a33565b9050676765c793fa10079d601b1b610ad68285612a06565b610ae09190612a33565b9392505050565b3360008181526003602090815260408083206001600160a01b038716808552925280832085905551919290917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92590610b429086815260200190565b60405180910390a35060015b92915050565b6005546000908190600160c01b90046001600160401b03164211610b83576005546001600160c01b0316610bd3565b600554600654676765c793fa10079d601b1b916001600160c01b03811691610bbf91610aa590600160c01b90046001600160401b0316426129f3565b610bc99190612a06565b610bd39190612a33565b9050610ae0610bed676765c793fa10079d601b1b85612a06565b82611beb565b6000610bff8484611277565b9050826001600160a01b03168261ffff167fb30a03a0e2a407f18ae0e83491331dc069d1521e292feffb071e61c8f7f406368387604051610c4a929190918252602082015260400190565b60405180910390a39392505050565b60006001600160a01b03831615801590610c7c57506001600160a01b0383163014155b610ca15760405162461bcd60e51b8152600401610c9890612a55565b60405180910390fd5b6001600160a01b03841660009081526002602052604090205482811015610cda5760405162461bcd60e51b8152600401610c9890612a84565b6001600160a01b0385163314610d92576001600160a01b03851660009081526003602090815260408083203384529091529020546000198114610d905783811015610d675760405162461bcd60e51b815260206004820152601c60248201527f53557364732f696e73756666696369656e742d616c6c6f77616e6365000000006044820152606401610c98565b6001600160a01b0386166000908152600360209081526040808320338452909152902084820390555b505b6001600160a01b038086166000818152600260205260408082208786039055928716808252908390208054870190559151600080516020612b8a83398151915290610de09087815260200190565b60405180910390a3506001949350505050565b33600090815260208190526040902054600114610e225760405162461bcd60e51b8152600401610c9890612abb565b816239b9b960e91b03610eee57676765c793fa10079d601b1b811015610e825760405162461bcd60e51b815260206004820152601560248201527453557364732f77726f6e672d7373722d76616c756560581b6044820152606401610c98565b6005546001600160401b03600160c01b909104164214610ee45760405162461bcd60e51b815260206004820152601860248201527f53557364732f6368692d6e6f742d75702d746f2d6461746500000000000000006044820152606401610c98565b6006819055610f36565b60405162461bcd60e51b815260206004820152601d60248201527f53557364732f66696c652d756e7265636f676e697a65642d706172616d0000006044820152606401610c98565b817fe986e40cc8c151830d4f61050f4fb2e4add8567caad2d5f5496f9158e91fe4c782604051610f6891815260200190565b60405180910390a25050565b6000610a3546611c19565b6000610b4e82610a3a565b610f92611cee565b610f9b82611d95565b610fa58282611dc7565b5050565b6000610fb3611e89565b50600080516020612b6a83398151915290565b33600090815260208190526040902054600114610ff55760405162461bcd60e51b8152600401610c9890612abb565b6001600160a01b03811660008181526020819052604080822060019055517fdd0e34038ac38b2a1ce960229778ac48a8719bc900b6c4f8d0475c6e8b385a609190a250565b6000611044611376565b611059676765c793fa10079d601b1b85612a06565b6110639190612a33565b9050610b4e838284611ed2565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff1615906001600160401b03166000811580156110b55750825b90506000826001600160401b031660011480156110d15750303b155b9050811580156110df575080155b156110fd5760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff19166001178555831561112757845460ff60401b1916600160401b1785555b61112f61202b565b676765c793fa10079d601b1b600160c01b426001600160401b03160281176005556006556040516328ec8bf160e21b81527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811660048301527f0000000000000000000000000000000000000000000000000000000000000000169063a3b22fc490602401600060405180830381600087803b1580156111d757600080fd5b505af11580156111eb573d6000803e3d6000fd5b50503360008181526020819052604080822060019055519193507fdd0e34038ac38b2a1ce960229778ac48a8719bc900b6c4f8d0475c6e8b385a60925090a2831561127057845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050565b600061129f611284611376565b61128e9085612a06565b676765c793fa10079d601b1b611beb565b9050610b4e818484611ed2565b60006112b8848461103a565b9050826001600160a01b03168261ffff167fb30a03a0e2a407f18ae0e83491331dc069d1521e292feffb071e61c8f7f406368684604051610c4a929190918252602082015260400190565b336000908152602081905260409020546001146113325760405162461bcd60e51b8152600401610c9890612abb565b6001600160a01b038116600081815260208190526040808220829055517f184450df2e323acec0ed3b5c7531b81f9b4cdef7914dfd4c0a4317416bb5251b9190a250565b6005546000906001600160c01b03811690600160c01b90046001600160401b0316824282101561159657676765c793fa10079d601b1b836113bf6006548542610aa591906129f3565b6113c99190612a06565b6113d39190612a33565b600154909450676765c793fa10079d601b1b6113ef8583612a06565b6113f99190612a33565b676765c793fa10079d601b1b61140f8784612a06565b6114199190612a33565b61142391906129f3565b91506001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001663f24e23eb7f00000000000000000000000000000000000000000000000000000000000000003061148b676765c793fa10079d601b1b87612a06565b6040516001600160e01b031960e086901b1681526001600160a01b0393841660048201529290911660248301526044820152606401600060405180830381600087803b1580156114da57600080fd5b505af11580156114ee573d6000803e3d6000fd5b505060405163ef693bed60e01b8152306004820152602481018590527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316925063ef693bed9150604401600060405180830381600087803b15801561155a57600080fd5b505af115801561156e573d6000803e3d6000fd5b50505050506001600160401b034216600160c01b026001600160c01b0385161760055561159a565b8293505b60408051858152602081018390527fad1e8a53178522eb68a9d94d862bf30c841f709d2115f743eb6b34528751c79f910160405180910390a150505090565b814211156116205760405162461bcd60e51b815260206004820152601460248201527314d55cd91ccbdc195c9b5a5d0b595e1c1a5c995960621b6044820152606401610c98565b6001600160a01b03851661166c5760405162461bcd60e51b815260206004820152601360248201527229aab9b23997b4b73b30b634b216b7bbb732b960691b6044820152606401610c98565b6001600160a01b03851660009081526004602052604081208054600181019091559061169746611c19565b604080517f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c960208201526001600160a01b03808b169282019290925290881660608201526080810187905260a0810184905260c0810186905260e0016040516020818303038152906040528051906020012060405160200161173092919061190160f01b81526002810192909252602282015260420190565b604051602081830303815290604052805190602001209050611753878285612033565b6117965760405162461bcd60e51b815260206004820152601460248201527314d55cd91ccbda5b9d985b1a590b5c195c9b5a5d60621b6044820152606401610c98565b6001600160a01b038781166000818152600360209081526040808320948b168084529482529182902089905590518881527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a350505050505050565b60006001600160a01b0383161580159061181e57506001600160a01b0383163014155b61183a5760405162461bcd60e51b8152600401610c9890612a55565b336000908152600260205260409020548281101561186a5760405162461bcd60e51b8152600401610c9890612a84565b33600081815260026020908152604080832087860390556001600160a01b0388168084529281902080548801905551868152919291600080516020612b8a833981519152910160405180910390a35060019392505050565b6000610a35600080516020612b6a833981519152546001600160a01b031690565b6005546000908190600160c01b90046001600160401b03164211611912576005546001600160c01b0316611962565b600554600654676765c793fa10079d601b1b916001600160c01b0381169161194e91610aa590600160c01b90046001600160401b0316426129f3565b6119589190612a06565b6119629190612a33565b9050610ae061128e8285612a06565b600061199861198b676765c793fa10079d601b1b86612a06565b611993611376565b611beb565b9050610ae0848285856121c3565b6000676765c793fa10079d601b1b6119bc611376565b6119c69086612a06565b6119d09190612a33565b9050610ae0818585856121c3565b6005546000908190600160c01b90046001600160401b03164211611a0d576005546001600160c01b0316611a5d565b600554600654676765c793fa10079d601b1b916001600160c01b03811691611a4991610aa590600160c01b90046001600160401b0316426129f3565b611a539190612a06565b611a5d9190612a33565b905080610ad6676765c793fa10079d601b1b85612a06565b6001600160a01b038116600090815260026020526040812054610b4e90610a3a565b611ae587878787868689604051602001611ad193929190928352602083019190915260f81b6001600160f81b031916604082015260410190565b6040516020818303038152906040526115d9565b50505050505050565b6000610b4e826119de565b6000828015611bc357600183168015611b1457849250611b23565b676765c793fa10079d601b1b92505b506002909204916b019d971e4fe8401e740000005b8315611bbd578485028586820414611b4f57600080fd5b81810181811015611b5f57600080fd5b676765c793fa10079d601b1b90049550506001841615611bb2578483028386820414158615151615611b9057600080fd5b81810181811015611ba057600080fd5b676765c793fa10079d601b1b90049350505b600284049350611b38565b50611be4565b828015611bd35760009250611be2565b676765c793fa10079d601b1b92505b505b5092915050565b600082600003611bfc576000610ae0565b816001840381611c0e57611c0e612a1d565b046001019392505050565b604080518082018252600c81526b536176696e6773205553445360a01b6020918201528151808301835260018152603160f81b9082015281517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f818301527f7b833ce3d9e5473168246d98a161bea2c6ea238198d3a0a9e9edb9c1eb00b9f9818401527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc6606082015260808101939093523060a0808501919091528251808503909101815260c0909301909152815191012090565b306001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161480611d7557507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316611d69600080516020612b6a833981519152546001600160a01b031690565b6001600160a01b031614155b15611d935760405163703e46dd60e11b815260040160405180910390fd5b565b33600090815260208190526040902054600114611dc45760405162461bcd60e51b8152600401610c9890612abb565b50565b816001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015611e21575060408051601f3d908101601f19168201909252611e1e91810190612ae9565b60015b611e4957604051634c9c8ce360e01b81526001600160a01b0383166004820152602401610c98565b600080516020612b6a8339815191528114611e7a57604051632a87526960e21b815260048101829052602401610c98565b611e8483836123d8565b505050565b306001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614611d935760405163703e46dd60e11b815260040160405180910390fd5b6001600160a01b03811615801590611ef357506001600160a01b0381163014155b611f0f5760405162461bcd60e51b8152600401610c9890612a55565b6040516323b872dd60e01b8152336004820152306024820152604481018490527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906323b872dd90606401600060405180830381600087803b158015611f7d57600080fd5b505af1158015611f91573d6000803e3d6000fd5b505050506001600160a01b0381166000818152600260209081526040918290208054860190556001805486019055815186815290810185905233917fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d7910160405180910390a36040518281526001600160a01b03821690600090600080516020612b8a8339815191529060200160405180910390a3505050565b611d9361242e565b600081516041036120d057602082810151604080850151606080870151835160008082529681018086528a9052951a928501839052840183905260808401819052919260019060a0016020604051602081039080840390855afa15801561209e573d6000803e3d6000fd5b505050602060405103516001600160a01b0316876001600160a01b0316036120cc5760019350505050610ae0565b5050505b6001600160a01b0384163b15610ae057600080856001600160a01b03168585604051602401612100929190612b02565b60408051601f198184030181529181526020820180516001600160e01b0316630b135d3f60e11b179052516121359190612b23565b600060405180830381855afa9150503d8060008114612170576040519150601f19603f3d011682016040523d82523d6000602084013e612175565b606091505b5091509150818015612188575080516020145b80156121b957508051630b135d3f60e11b906121ad9083016020908101908401612b3f565b6001600160e01b031916145b9695505050505050565b6001600160a01b038116600090815260026020526040902054838110156121fc5760405162461bcd60e51b8152600401610c9890612a84565b6001600160a01b03821633146122b4576001600160a01b038216600090815260036020908152604080832033845290915290205460001981146122b257848110156122895760405162461bcd60e51b815260206004820152601c60248201527f53557364732f696e73756666696369656e742d616c6c6f77616e6365000000006044820152606401610c98565b6001600160a01b0383166000908152600360209081526040808320338452909152902085820390555b505b6001600160a01b038281166000908152600260205260409081902086840390556001805487900390555163a9059cbb60e01b81528482166004820152602481018790527f00000000000000000000000000000000000000000000000000000000000000009091169063a9059cbb90604401600060405180830381600087803b15801561233f57600080fd5b505af1158015612353573d6000803e3d6000fd5b5050604051868152600092506001600160a01b0385169150600080516020612b8a8339815191529060200160405180910390a360408051868152602081018690526001600160a01b03808516929086169133917ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db910160405180910390a45050505050565b6123e182612477565b6040516001600160a01b038316907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a280511561242657611e8482826124dc565b610fa5612552565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff16611d9357604051631afcd79f60e31b815260040160405180910390fd5b806001600160a01b03163b6000036124ad57604051634c9c8ce360e01b81526001600160a01b0382166004820152602401610c98565b600080516020612b6a83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6060600080846001600160a01b0316846040516124f99190612b23565b600060405180830381855af49150503d8060008114612534576040519150601f19603f3d011682016040523d82523d6000602084013e612539565b606091505b5091509150612549858383612571565b95945050505050565b3415611d935760405163b398979f60e01b815260040160405180910390fd5b60608261258657612581826125cd565b610ae0565b815115801561259d57506001600160a01b0384163b155b156125c657604051639996b31560e01b81526001600160a01b0385166004820152602401610c98565b5080610ae0565b8051156125dd5780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b60005b838110156126115781810151838201526020016125f9565b50506000910152565b600081518084526126328160208601602086016125f6565b601f01601f19169290920160200192915050565b602081526000610ae0602083018461261a565b60006020828403121561266b57600080fd5b5035919050565b80356001600160a01b038116811461268957600080fd5b919050565b600080604083850312156126a157600080fd5b6126aa83612672565b946020939093013593505050565b6000806000606084860312156126cd57600080fd5b833592506126dd60208501612672565b9150604084013561ffff811681146126f457600080fd5b809150509250925092565b60008060006060848603121561271457600080fd5b61271d84612672565b925061272b60208501612672565b9150604084013590509250925092565b6000806040838503121561274e57600080fd5b50508035926020909101359150565b60006020828403121561276f57600080fd5b610ae082612672565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261279f57600080fd5b81356001600160401b03808211156127b9576127b9612778565b604051601f8301601f19908116603f011681019082821181831017156127e1576127e1612778565b816040528381528660208588010111156127fa57600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806040838503121561282d57600080fd5b61283683612672565b915060208301356001600160401b0381111561285157600080fd5b61285d8582860161278e565b9150509250929050565b6000806040838503121561287a57600080fd5b8235915061288a60208401612672565b90509250929050565b600080600080600060a086880312156128ab57600080fd5b6128b486612672565b94506128c260208701612672565b9350604086013592506060860135915060808601356001600160401b038111156128eb57600080fd5b6128f78882890161278e565b9150509295509295909350565b60008060006060848603121561291957600080fd5b8335925061292960208501612672565b915061293760408501612672565b90509250925092565b600080600080600080600060e0888a03121561295b57600080fd5b61296488612672565b965061297260208901612672565b95506040880135945060608801359350608088013560ff8116811461299657600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156129c657600080fd5b6129cf83612672565b915061288a60208401612672565b634e487b7160e01b600052601160045260246000fd5b81810381811115610b4e57610b4e6129dd565b8082028115828204841417610b4e57610b4e6129dd565b634e487b7160e01b600052601260045260246000fd5b600082612a5057634e487b7160e01b600052601260045260246000fd5b500490565b60208082526015908201527453557364732f696e76616c69642d6164647265737360581b604082015260600190565b6020808252601a908201527f53557364732f696e73756666696369656e742d62616c616e6365000000000000604082015260600190565b60208082526014908201527314d55cd91ccbdb9bdd0b585d5d1a1bdc9a5e995960621b604082015260600190565b600060208284031215612afb57600080fd5b5051919050565b828152604060208201526000612b1b604083018461261a565b949350505050565b60008251612b358184602087016125f6565b9190910192915050565b600060208284031215612b5157600080fd5b81516001600160e01b031981168114610ae057600080fdfe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbcddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220efe51b4da684074b634b858f100541c75822df39c037f225ba038ffe08b7c09d64736f6c634300081500330000000000000000000000003c0f895007ca717aa01c8693e59df1e8c3777feb000000000000000000000000a950524441892a31ebddf91d3ceefa04bf454466","name":"SUsds","is_blueprint":false,"license_type":"none","is_fully_verified":false,"is_verified_via_eth_bytecode_db":true,"language":"solidity","evm_version":"paris","can_be_visualized_via_sol2uml":true,"is_verified_via_sourcify":true,"additional_sources":[{"file_path":"lib/openzeppelin-contracts-upgradeable/contracts/proxy/utils/Initializable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.20;\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n *     function initialize() initializer public {\n *         __ERC20_init(\"MyToken\", \"MTK\");\n *     }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n *     function initializeV2() reinitializer(2) public {\n *         __ERC20Permit_init(\"MyToken\");\n *     }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n *     _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n    /**\n     * @dev Storage of the initializable contract.\n     *\n     * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions\n     * when using with upgradeable contracts.\n     *\n     * @custom:storage-location erc7201:openzeppelin.storage.Initializable\n     */\n    struct InitializableStorage {\n        /**\n         * @dev Indicates that the contract has been initialized.\n         */\n        uint64 _initialized;\n        /**\n         * @dev Indicates that the contract is in the process of being initialized.\n         */\n        bool _initializing;\n    }\n\n    // keccak256(abi.encode(uint256(keccak256(\"openzeppelin.storage.Initializable\")) - 1)) & ~bytes32(uint256(0xff))\n    bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00;\n\n    /**\n     * @dev The contract is already initialized.\n     */\n    error InvalidInitialization();\n\n    /**\n     * @dev The contract is not initializing.\n     */\n    error NotInitializing();\n\n    /**\n     * @dev Triggered when the contract has been initialized or reinitialized.\n     */\n    event Initialized(uint64 version);\n\n    /**\n     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n     * `onlyInitializing` functions can be used to initialize parent contracts.\n     *\n     * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any\n     * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in\n     * production.\n     *\n     * Emits an {Initialized} event.\n     */\n    modifier initializer() {\n        // solhint-disable-next-line var-name-mixedcase\n        InitializableStorage storage $ = _getInitializableStorage();\n\n        // Cache values to avoid duplicated sloads\n        bool isTopLevelCall = !$._initializing;\n        uint64 initialized = $._initialized;\n\n        // Allowed calls:\n        // - initialSetup: the contract is not in the initializing state and no previous version was\n        //                 initialized\n        // - construction: the contract is initialized at version 1 (no reininitialization) and the\n        //                 current contract is just being deployed\n        bool initialSetup = initialized == 0 && isTopLevelCall;\n        bool construction = initialized == 1 && address(this).code.length == 0;\n\n        if (!initialSetup && !construction) {\n            revert InvalidInitialization();\n        }\n        $._initialized = 1;\n        if (isTopLevelCall) {\n            $._initializing = true;\n        }\n        _;\n        if (isTopLevelCall) {\n            $._initializing = false;\n            emit Initialized(1);\n        }\n    }\n\n    /**\n     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n     * used to initialize parent contracts.\n     *\n     * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n     * are added through upgrades and that require initialization.\n     *\n     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n     * cannot be nested. If one is invoked in the context of another, execution will revert.\n     *\n     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n     * a contract, executing them in the right order is up to the developer or operator.\n     *\n     * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization.\n     *\n     * Emits an {Initialized} event.\n     */\n    modifier reinitializer(uint64 version) {\n        // solhint-disable-next-line var-name-mixedcase\n        InitializableStorage storage $ = _getInitializableStorage();\n\n        if ($._initializing || $._initialized >= version) {\n            revert InvalidInitialization();\n        }\n        $._initialized = version;\n        $._initializing = true;\n        _;\n        $._initializing = false;\n        emit Initialized(version);\n    }\n\n    /**\n     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n     * {initializer} and {reinitializer} modifiers, directly or indirectly.\n     */\n    modifier onlyInitializing() {\n        _checkInitializing();\n        _;\n    }\n\n    /**\n     * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}.\n     */\n    function _checkInitializing() internal view virtual {\n        if (!_isInitializing()) {\n            revert NotInitializing();\n        }\n    }\n\n    /**\n     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n     * through proxies.\n     *\n     * Emits an {Initialized} event the first time it is successfully executed.\n     */\n    function _disableInitializers() internal virtual {\n        // solhint-disable-next-line var-name-mixedcase\n        InitializableStorage storage $ = _getInitializableStorage();\n\n        if ($._initializing) {\n            revert InvalidInitialization();\n        }\n        if ($._initialized != type(uint64).max) {\n            $._initialized = type(uint64).max;\n            emit Initialized(type(uint64).max);\n        }\n    }\n\n    /**\n     * @dev Returns the highest version that has been initialized. See {reinitializer}.\n     */\n    function _getInitializedVersion() internal view returns (uint64) {\n        return _getInitializableStorage()._initialized;\n    }\n\n    /**\n     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n     */\n    function _isInitializing() internal view returns (bool) {\n        return _getInitializableStorage()._initializing;\n    }\n\n    /**\n     * @dev Returns a pointer to the storage namespace.\n     */\n    // solhint-disable-next-line var-name-mixedcase\n    function _getInitializableStorage() private pure returns (InitializableStorage storage $) {\n        assembly {\n            $.slot := INITIALIZABLE_STORAGE\n        }\n    }\n}\n"},{"file_path":"lib/openzeppelin-contracts-upgradeable/contracts/proxy/utils/UUPSUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.20;\n\nimport {IERC1822Proxiable} from \"@openzeppelin/contracts/interfaces/draft-IERC1822.sol\";\nimport {ERC1967Utils} from \"@openzeppelin/contracts/proxy/ERC1967/ERC1967Utils.sol\";\nimport {Initializable} from \"./Initializable.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n */\nabstract contract UUPSUpgradeable is Initializable, IERC1822Proxiable {\n    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable\n    address private immutable __self = address(this);\n\n    /**\n     * @dev The version of the upgrade interface of the contract. If this getter is missing, both `upgradeTo(address)`\n     * and `upgradeToAndCall(address,bytes)` are present, and `upgradeTo` must be used if no function should be called,\n     * while `upgradeToAndCall` will invoke the `receive` function if the second argument is the empty byte string.\n     * If the getter returns `\"5.0.0\"`, only `upgradeToAndCall(address,bytes)` is present, and the second argument must\n     * be the empty byte string if no function should be called, making it impossible to invoke the `receive` function\n     * during an upgrade.\n     */\n    string public constant UPGRADE_INTERFACE_VERSION = \"5.0.0\";\n\n    /**\n     * @dev The call is from an unauthorized context.\n     */\n    error UUPSUnauthorizedCallContext();\n\n    /**\n     * @dev The storage `slot` is unsupported as a UUID.\n     */\n    error UUPSUnsupportedProxiableUUID(bytes32 slot);\n\n    /**\n     * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n     * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n     * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n     * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n     * fail.\n     */\n    modifier onlyProxy() {\n        _checkProxy();\n        _;\n    }\n\n    /**\n     * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n     * callable on the implementing contract but not through proxies.\n     */\n    modifier notDelegated() {\n        _checkNotDelegated();\n        _;\n    }\n\n    function __UUPSUpgradeable_init() internal onlyInitializing {\n    }\n\n    function __UUPSUpgradeable_init_unchained() internal onlyInitializing {\n    }\n    /**\n     * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n     * implementation. It is used to validate the implementation's compatibility when performing an upgrade.\n     *\n     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n     * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n     */\n    function proxiableUUID() external view virtual notDelegated returns (bytes32) {\n        return ERC1967Utils.IMPLEMENTATION_SLOT;\n    }\n\n    /**\n     * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n     * encoded in `data`.\n     *\n     * Calls {_authorizeUpgrade}.\n     *\n     * Emits an {Upgraded} event.\n     *\n     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n     */\n    function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {\n        _authorizeUpgrade(newImplementation);\n        _upgradeToAndCallUUPS(newImplementation, data);\n    }\n\n    /**\n     * @dev Reverts if the execution is not performed via delegatecall or the execution\n     * context is not of a proxy with an ERC1967-compliant implementation pointing to self.\n     * See {_onlyProxy}.\n     */\n    function _checkProxy() internal view virtual {\n        if (\n            address(this) == __self || // Must be called through delegatecall\n            ERC1967Utils.getImplementation() != __self // Must be called through an active proxy\n        ) {\n            revert UUPSUnauthorizedCallContext();\n        }\n    }\n\n    /**\n     * @dev Reverts if the execution is performed via delegatecall.\n     * See {notDelegated}.\n     */\n    function _checkNotDelegated() internal view virtual {\n        if (address(this) != __self) {\n            // Must not be called through delegatecall\n            revert UUPSUnauthorizedCallContext();\n        }\n    }\n\n    /**\n     * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n     * {upgradeToAndCall}.\n     *\n     * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n     *\n     * ```solidity\n     * function _authorizeUpgrade(address) internal onlyOwner {}\n     * ```\n     */\n    function _authorizeUpgrade(address newImplementation) internal virtual;\n\n    /**\n     * @dev Performs an implementation upgrade with a security check for UUPS proxies, and additional setup call.\n     *\n     * As a security check, {proxiableUUID} is invoked in the new implementation, and the return value\n     * is expected to be the implementation slot in ERC1967.\n     *\n     * Emits an {IERC1967-Upgraded} event.\n     */\n    function _upgradeToAndCallUUPS(address newImplementation, bytes memory data) private {\n        try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n            if (slot != ERC1967Utils.IMPLEMENTATION_SLOT) {\n                revert UUPSUnsupportedProxiableUUID(slot);\n            }\n            ERC1967Utils.upgradeToAndCall(newImplementation, data);\n        } catch {\n            // The implementation is not UUPS\n            revert ERC1967Utils.ERC1967InvalidImplementation(newImplementation);\n        }\n    }\n}\n"},{"file_path":"lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC1822.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.20;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822Proxiable {\n    /**\n     * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n     * address.\n     *\n     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n     * function revert if invoked through a proxy.\n     */\n    function proxiableUUID() external view returns (bytes32);\n}\n"},{"file_path":"lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/proxy/ERC1967/ERC1967Utils.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)\n\npragma solidity ^0.8.20;\n\nimport {IBeacon} from \"../beacon/IBeacon.sol\";\nimport {Address} from \"../../utils/Address.sol\";\nimport {StorageSlot} from \"../../utils/StorageSlot.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n */\nlibrary ERC1967Utils {\n    // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.\n    // This will be fixed in Solidity 0.8.21. At that point we should remove these events.\n    /**\n     * @dev Emitted when the implementation is upgraded.\n     */\n    event Upgraded(address indexed implementation);\n\n    /**\n     * @dev Emitted when the admin account has changed.\n     */\n    event AdminChanged(address previousAdmin, address newAdmin);\n\n    /**\n     * @dev Emitted when the beacon is changed.\n     */\n    event BeaconUpgraded(address indexed beacon);\n\n    /**\n     * @dev Storage slot with the address of the current implementation.\n     * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1.\n     */\n    // solhint-disable-next-line private-vars-leading-underscore\n    bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n    /**\n     * @dev The `implementation` of the proxy is invalid.\n     */\n    error ERC1967InvalidImplementation(address implementation);\n\n    /**\n     * @dev The `admin` of the proxy is invalid.\n     */\n    error ERC1967InvalidAdmin(address admin);\n\n    /**\n     * @dev The `beacon` of the proxy is invalid.\n     */\n    error ERC1967InvalidBeacon(address beacon);\n\n    /**\n     * @dev An upgrade function sees `msg.value > 0` that may be lost.\n     */\n    error ERC1967NonPayable();\n\n    /**\n     * @dev Returns the current implementation address.\n     */\n    function getImplementation() internal view returns (address) {\n        return StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value;\n    }\n\n    /**\n     * @dev Stores a new address in the EIP1967 implementation slot.\n     */\n    function _setImplementation(address newImplementation) private {\n        if (newImplementation.code.length == 0) {\n            revert ERC1967InvalidImplementation(newImplementation);\n        }\n        StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;\n    }\n\n    /**\n     * @dev Performs implementation upgrade with additional setup call if data is nonempty.\n     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected\n     * to avoid stuck value in the contract.\n     *\n     * Emits an {IERC1967-Upgraded} event.\n     */\n    function upgradeToAndCall(address newImplementation, bytes memory data) internal {\n        _setImplementation(newImplementation);\n        emit Upgraded(newImplementation);\n\n        if (data.length > 0) {\n            Address.functionDelegateCall(newImplementation, data);\n        } else {\n            _checkNonPayable();\n        }\n    }\n\n    /**\n     * @dev Storage slot with the admin of the contract.\n     * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1.\n     */\n    // solhint-disable-next-line private-vars-leading-underscore\n    bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n    /**\n     * @dev Returns the current admin.\n     *\n     * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using\n     * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.\n     * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`\n     */\n    function getAdmin() internal view returns (address) {\n        return StorageSlot.getAddressSlot(ADMIN_SLOT).value;\n    }\n\n    /**\n     * @dev Stores a new address in the EIP1967 admin slot.\n     */\n    function _setAdmin(address newAdmin) private {\n        if (newAdmin == address(0)) {\n            revert ERC1967InvalidAdmin(address(0));\n        }\n        StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;\n    }\n\n    /**\n     * @dev Changes the admin of the proxy.\n     *\n     * Emits an {IERC1967-AdminChanged} event.\n     */\n    function changeAdmin(address newAdmin) internal {\n        emit AdminChanged(getAdmin(), newAdmin);\n        _setAdmin(newAdmin);\n    }\n\n    /**\n     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n     * This is the keccak-256 hash of \"eip1967.proxy.beacon\" subtracted by 1.\n     */\n    // solhint-disable-next-line private-vars-leading-underscore\n    bytes32 internal constant BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n    /**\n     * @dev Returns the current beacon.\n     */\n    function getBeacon() internal view returns (address) {\n        return StorageSlot.getAddressSlot(BEACON_SLOT).value;\n    }\n\n    /**\n     * @dev Stores a new beacon in the EIP1967 beacon slot.\n     */\n    function _setBeacon(address newBeacon) private {\n        if (newBeacon.code.length == 0) {\n            revert ERC1967InvalidBeacon(newBeacon);\n        }\n\n        StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;\n\n        address beaconImplementation = IBeacon(newBeacon).implementation();\n        if (beaconImplementation.code.length == 0) {\n            revert ERC1967InvalidImplementation(beaconImplementation);\n        }\n    }\n\n    /**\n     * @dev Change the beacon and trigger a setup call if data is nonempty.\n     * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected\n     * to avoid stuck value in the contract.\n     *\n     * Emits an {IERC1967-BeaconUpgraded} event.\n     *\n     * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since\n     * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for\n     * efficiency.\n     */\n    function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {\n        _setBeacon(newBeacon);\n        emit BeaconUpgraded(newBeacon);\n\n        if (data.length > 0) {\n            Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);\n        } else {\n            _checkNonPayable();\n        }\n    }\n\n    /**\n     * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract\n     * if an upgrade doesn't perform an initialization call.\n     */\n    function _checkNonPayable() private {\n        if (msg.value > 0) {\n            revert ERC1967NonPayable();\n        }\n    }\n}\n"},{"file_path":"lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/proxy/beacon/IBeacon.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.20;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeacon {\n    /**\n     * @dev Must return an address that can be used as a delegate call target.\n     *\n     * {UpgradeableBeacon} will check that this address is a contract.\n     */\n    function implementation() external view returns (address);\n}\n"},{"file_path":"lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/utils/Address.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)\n\npragma solidity ^0.8.20;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n    /**\n     * @dev The ETH balance of the account is not enough to perform the operation.\n     */\n    error AddressInsufficientBalance(address account);\n\n    /**\n     * @dev There's no code at `target` (it is not a contract).\n     */\n    error AddressEmptyCode(address target);\n\n    /**\n     * @dev A call to an address target failed. The target may have reverted.\n     */\n    error FailedInnerCall();\n\n    /**\n     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n     * `recipient`, forwarding all available gas and reverting on errors.\n     *\n     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n     * of certain opcodes, possibly making contracts go over the 2300 gas limit\n     * imposed by `transfer`, making them unable to receive funds via\n     * `transfer`. {sendValue} removes this limitation.\n     *\n     * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n     *\n     * IMPORTANT: because control is transferred to `recipient`, care must be\n     * taken to not create reentrancy vulnerabilities. Consider using\n     * {ReentrancyGuard} or the\n     * https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n     */\n    function sendValue(address payable recipient, uint256 amount) internal {\n        if (address(this).balance < amount) {\n            revert AddressInsufficientBalance(address(this));\n        }\n\n        (bool success, ) = recipient.call{value: amount}(\"\");\n        if (!success) {\n            revert FailedInnerCall();\n        }\n    }\n\n    /**\n     * @dev Performs a Solidity function call using a low level `call`. A\n     * plain `call` is an unsafe replacement for a function call: use this\n     * function instead.\n     *\n     * If `target` reverts with a revert reason or custom error, it is bubbled\n     * up by this function (like regular Solidity function calls). However, if\n     * the call reverted with no returned reason, this function reverts with a\n     * {FailedInnerCall} error.\n     *\n     * Returns the raw returned data. To convert to the expected return value,\n     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n     *\n     * Requirements:\n     *\n     * - `target` must be a contract.\n     * - calling `target` with `data` must not revert.\n     */\n    function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n        return functionCallWithValue(target, data, 0);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but also transferring `value` wei to `target`.\n     *\n     * Requirements:\n     *\n     * - the calling contract must have an ETH balance of at least `value`.\n     * - the called Solidity function must be `payable`.\n     */\n    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {\n        if (address(this).balance < value) {\n            revert AddressInsufficientBalance(address(this));\n        }\n        (bool success, bytes memory returndata) = target.call{value: value}(data);\n        return verifyCallResultFromTarget(target, success, returndata);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a static call.\n     */\n    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n        (bool success, bytes memory returndata) = target.staticcall(data);\n        return verifyCallResultFromTarget(target, success, returndata);\n    }\n\n    /**\n     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n     * but performing a delegate call.\n     */\n    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n        (bool success, bytes memory returndata) = target.delegatecall(data);\n        return verifyCallResultFromTarget(target, success, returndata);\n    }\n\n    /**\n     * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target\n     * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an\n     * unsuccessful call.\n     */\n    function verifyCallResultFromTarget(\n        address target,\n        bool success,\n        bytes memory returndata\n    ) internal view returns (bytes memory) {\n        if (!success) {\n            _revert(returndata);\n        } else {\n            // only check if target is a contract if the call was successful and the return data is empty\n            // otherwise we already know that it was a contract\n            if (returndata.length == 0 && target.code.length == 0) {\n                revert AddressEmptyCode(target);\n            }\n            return returndata;\n        }\n    }\n\n    /**\n     * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the\n     * revert reason or with a default {FailedInnerCall} error.\n     */\n    function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {\n        if (!success) {\n            _revert(returndata);\n        } else {\n            return returndata;\n        }\n    }\n\n    /**\n     * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.\n     */\n    function _revert(bytes memory returndata) private pure {\n        // Look for revert reason and bubble it up if present\n        if (returndata.length > 0) {\n            // The easiest way to bubble the revert reason is using memory via assembly\n            /// @solidity memory-safe-assembly\n            assembly {\n                let returndata_size := mload(returndata)\n                revert(add(32, returndata), returndata_size)\n            }\n        } else {\n            revert FailedInnerCall();\n        }\n    }\n}\n"},{"file_path":"lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/utils/StorageSlot.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)\n// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.\n\npragma solidity ^0.8.20;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```solidity\n * contract ERC1967 {\n *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n *     function _getImplementation() internal view returns (address) {\n *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n *     }\n *\n *     function _setImplementation(address newImplementation) internal {\n *         require(newImplementation.code.length > 0);\n *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n *     }\n * }\n * ```\n */\nlibrary StorageSlot {\n    struct AddressSlot {\n        address value;\n    }\n\n    struct BooleanSlot {\n        bool value;\n    }\n\n    struct Bytes32Slot {\n        bytes32 value;\n    }\n\n    struct Uint256Slot {\n        uint256 value;\n    }\n\n    struct StringSlot {\n        string value;\n    }\n\n    struct BytesSlot {\n        bytes value;\n    }\n\n    /**\n     * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n     */\n    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n     */\n    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n     */\n    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n     */\n    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `StringSlot` with member `value` located at `slot`.\n     */\n    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.\n     */\n    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := store.slot\n        }\n    }\n\n    /**\n     * @dev Returns an `BytesSlot` with member `value` located at `slot`.\n     */\n    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.\n     */\n    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := store.slot\n        }\n    }\n}\n"}],"certified":false,"conflicting_implementations":null,"abi":[{"inputs":[{"internalType":"address","name":"usdsJoin_","type":"address"},{"internalType":"address","name":"vow_","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[{"internalType":"address","name":"implementation","type":"address"}],"name":"ERC1967InvalidImplementation","type":"error"},{"inputs":[],"name":"ERC1967NonPayable","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"UUPSUnauthorizedCallContext","type":"error"},{"inputs":[{"internalType":"bytes32","name":"slot","type":"bytes32"}],"name":"UUPSUnsupportedProxiableUUID","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"usr","type":"address"}],"name":"Deny","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"chi","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"diff","type":"uint256"}],"name":"Drip","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"what","type":"bytes32"},{"indexed":false,"internalType":"uint256","name":"data","type":"uint256"}],"name":"File","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint16","name":"referral","type":"uint16"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Referral","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"usr","type":"address"}],"name":"Rely","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Withdraw","type":"event"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PERMIT_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"UPGRADE_INTERFACE_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"asset","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"chi","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"convertToAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"convertToShares","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"usr","type":"address"}],"name":"deny","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint16","name":"referral","type":"uint16"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"drip","outputs":[{"internalType":"uint256","name":"nChi","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"what","type":"bytes32"},{"internalType":"uint256","name":"data","type":"uint256"}],"name":"file","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getImplementation","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"maxDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"maxMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxRedeem","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxWithdraw","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint16","name":"referral","type":"uint16"}],"name":"mint","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"mint","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"previewDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"previewMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"previewRedeem","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"previewWithdraw","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"redeem","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"usr","type":"address"}],"name":"rely","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rho","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ssr","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"usds","outputs":[{"internalType":"contract UsdsLike","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"usdsJoin","outputs":[{"internalType":"contract UsdsJoinLike","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"vat","outputs":[{"internalType":"contract VatLike","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"vow","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"wards","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"withdraw","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"}],"is_changed_bytecode":false,"is_partially_verified":true,"constructor_args":"0000000000000000000000003c0f895007ca717aa01c8693e59df1e8c3777feb000000000000000000000000a950524441892a31ebddf91d3ceefa04bf454466"}