ETH Price: $2,048.30 (-0.71%)
Gas: 0.3 Gwei

Transaction Decoder

Block:
21315935 at Dec-02-2024 04:11:59 PM +UTC
Transaction Fee:
0.005836188789236675 ETH $11.95
Gas Used:
197,215 Gas / 29.593026845 Gwei

Emitted Events:

196 0xd75ccdd5aa60f2bda969db155bbbb3beeeb4618a.0x1cff79cd00000000000000000000000000000000000000000000000000000000( 0x1cff79cd00000000000000000000000000000000000000000000000000000000, 0x00000000000000000000000002024879912fdbe708f606c71326c3d1bbe48ab8, 0x0000000000000000000000001ef664440dc7342253780472dad90d9a3258a71d, 0x0000000000000000000000000000000000000000000000000000000000000040, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000004000000000, 000000000000000000000000000000000000000000000000000001441cff79cd, 0000000000000000000000001ef664440dc7342253780472dad90d9a3258a71d, 0000000000000000000000000000000000000000000000000000000000000040, 00000000000000000000000000000000000000000000000000000000000000c4, 389f87ff00000000000000000000000000000000000000000000000000000000, 0000002000000000000000000000000000000000000000000000000000000000, 000000800000000000000000000000006b175474e89094c44da98b954eedeac4, 95271d0f00000000000000000000000002024879912fdbe708f606c71326c3d1, bbe48ab800000000000000000000000002024879912fdbe708f606c71326c3d1, bbe48ab8000000000000000000000000000000000000000000000fe1b4353244, 917c000000000000000000000000000000000000000000000000000000000000 )
197 Dai.Transfer( src=[Sender] 0x02024879912fdbe708f606c71326c3d1bbe48ab8, dst=[Receiver] 0xd75ccdd5aa60f2bda969db155bbbb3beeeb4618a, wad=74999000000000000000000 )
198 Dai.Approval( src=[Receiver] 0xd75ccdd5aa60f2bda969db155bbbb3beeeb4618a, guy=DaiUsds, wad=74999000000000000000000 )
199 Dai.Transfer( src=[Receiver] 0xd75ccdd5aa60f2bda969db155bbbb3beeeb4618a, dst=DaiUsds, wad=74999000000000000000000 )
200 Vat.0xbb35783b00000000000000000000000000000000000000000000000000000000( 0xbb35783b00000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000009759a6ac90977b93b58547b4a71c78317f391a28, 0x0000000000000000000000003225737a9bbb6473cb4a45b7244aca2befdb276a, 0x00000000000000000000003350ff790b4d462ca1300c7f1e3ce8600000000000, 0000000000000000000000000000000000000000000000000000000000000020, 00000000000000000000000000000000000000000000000000000000000000e0, bb35783b0000000000000000000000009759a6ac90977b93b58547b4a71c7831, 7f391a280000000000000000000000003225737a9bbb6473cb4a45b7244aca2b, efdb276a00000000000000000000003350ff790b4d462ca1300c7f1e3ce86000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )
201 Dai.Transfer( src=DaiUsds, dst=0x0000000000000000000000000000000000000000, wad=74999000000000000000000 )
202 DaiJoin.0x3b4da69f00000000000000000000000000000000000000000000000000000000( 0x3b4da69f00000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000003225737a9bbb6473cb4a45b7244aca2befdb276a, 0x0000000000000000000000003225737a9bbb6473cb4a45b7244aca2befdb276a, 0x000000000000000000000000000000000000000000000fe1b4353244917c0000, 0000000000000000000000000000000000000000000000000000000000000020, 00000000000000000000000000000000000000000000000000000000000000e0, 3b4da69f0000000000000000000000003225737a9bbb6473cb4a45b7244aca2b, efdb276a000000000000000000000000000000000000000000000fe1b4353244, 917c000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )
203 Vat.0xbb35783b00000000000000000000000000000000000000000000000000000000( 0xbb35783b00000000000000000000000000000000000000000000000000000000, 0x0000000000000000000000003225737a9bbb6473cb4a45b7244aca2befdb276a, 0x0000000000000000000000003c0f895007ca717aa01c8693e59df1e8c3777feb, 0x00000000000000000000003350ff790b4d462ca1300c7f1e3ce8600000000000, 0000000000000000000000000000000000000000000000000000000000000020, 00000000000000000000000000000000000000000000000000000000000000e0, bb35783b0000000000000000000000003225737a9bbb6473cb4a45b7244aca2b, efdb276a0000000000000000000000003c0f895007ca717aa01c8693e59df1e8, c3777feb00000000000000000000003350ff790b4d462ca1300c7f1e3ce86000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000, 0000000000000000000000000000000000000000000000000000000000000000 )
204 ERC1967Proxy.0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef( 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, 0x0000000000000000000000000000000000000000000000000000000000000000, 0x00000000000000000000000002024879912fdbe708f606c71326c3d1bbe48ab8, 000000000000000000000000000000000000000000000fe1b4353244917c0000 )
205 UsdsJoin.Exit( caller=DaiUsds, usr=[Sender] 0x02024879912fdbe708f606c71326c3d1bbe48ab8, wad=74999000000000000000000 )
206 DaiUsds.DaiToUsds( caller=[Receiver] 0xd75ccdd5aa60f2bda969db155bbbb3beeeb4618a, usr=[Sender] 0x02024879912fdbe708f606c71326c3d1bbe48ab8, wad=74999000000000000000000 )
207 DefisaverLogger.ActionDirectEvent( 0xf28c1e8e1a8c97027796e625e1ed041028c9642e14da6e7ad2c18838a59a2d8c, 0x000000000000000000000000d75ccdd5aa60f2bda969db155bbbb3beeeb4618a, 0xdd5b6f152509d3575a2483bf78ef6231117e21bde656b4be32676bb729908435, 0000000000000000000000000000000000000000000000000000000000000020, 00000000000000000000000000000000000000000000000000000000000000a0, 0000000000000000000000006b175474e89094c44da98b954eedeac495271d0f, 00000000000000000000000002024879912fdbe708f606c71326c3d1bbe48ab8, 00000000000000000000000002024879912fdbe708f606c71326c3d1bbe48ab8, 000000000000000000000000000000000000000000000fe1b4353244917c0000, 000000000000000000000000000000000000000000000fe1b4353244917c0000 )

Account State Difference:

  Address   Before After State Difference Code
0x02024879...1Bbe48aB8
2.909622995845517393 Eth
Nonce: 257
2.903786807056280718 Eth
Nonce: 258
0.005836188789236675
0x35D1b3F3...259A0492B
(Sky: MCD Vat)
(Titan Builder)
14.417813088124381766 Eth14.417911695624381766 Eth0.0000986075
0x6B175474...495271d0F
0xdC035D45...1e407384F

Execution Trace

DSProxy #35,081.1cff79cd( )
  • McdTokenConverter.executeActionDirect( _callData=0x0000000000000000000000006B175474E89094C44DA98B954EEDEAC495271D0F00000000000000000000000002024879912FDBE708F606C71326C3D1BBE48AB800000000000000000000000002024879912FDBE708F606C71326C3D1BBE48AB8000000000000000000000000000000000000000000000FE1B4353244917C0000 )
    • Dai.transferFrom( src=0x02024879912FDbE708f606c71326C3d1Bbe48aB8, dst=0xD75CCdd5AA60F2BDa969DB155bBBb3BeEEb4618A, wad=74999000000000000000000 ) => ( True )
    • Dai.allowance( 0xD75CCdd5AA60F2BDa969DB155bBBb3BeEEb4618A, 0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A ) => ( 0 )
    • Dai.approve( usr=0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A, wad=74999000000000000000000 ) => ( True )
    • DaiUsds.daiToUsds( usr=0x02024879912FDbE708f606c71326C3d1Bbe48aB8, wad=74999000000000000000000 )
      • Dai.transferFrom( src=0xD75CCdd5AA60F2BDa969DB155bBBb3BeEEb4618A, dst=0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A, wad=74999000000000000000000 ) => ( True )
      • DaiJoin.join( usr=0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A, wad=74999000000000000000000 )
        • Vat.move( src=0x9759A6Ac90977b93B58547b4A71c78317f391A28, dst=0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A, rad=74999000000000000000000000000000000000000000000000 )
        • Dai.burn( usr=0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A, wad=74999000000000000000000 )
        • UsdsJoin.exit( usr=0x02024879912FDbE708f606c71326C3d1Bbe48aB8, wad=74999000000000000000000 )
          • Vat.move( src=0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A, dst=0x3C0f895007CA717Aa01c8693e59DF1e8C3777FEB, rad=74999000000000000000000000000000000000000000000000 )
          • ERC1967Proxy.40c10f19( )
            • Usds.mint( to=0x02024879912FDbE708f606c71326C3d1Bbe48aB8, value=74999000000000000000000 )
            • DefisaverLogger.logActionDirectEvent( _logName=McdTokenConverter, _data=0x0000000000000000000000006B175474E89094C44DA98B954EEDEAC495271D0F00000000000000000000000002024879912FDBE708F606C71326C3D1BBE48AB800000000000000000000000002024879912FDBE708F606C71326C3D1BBE48AB8000000000000000000000000000000000000000000000FE1B4353244917C0000000000000000000000000000000000000000000000000FE1B4353244917C0000 )
              File 1 of 9: Dai
              // hevm: flattened sources of /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/dai.sol
              pragma solidity =0.5.12;
              
              ////// /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/lib.sol
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU General Public License for more details.
              
              // You should have received a copy of the GNU General Public License
              // along with this program.  If not, see <http://www.gnu.org/licenses/>.
              
              /* pragma solidity 0.5.12; */
              
              contract LibNote {
                  event LogNote(
                      bytes4   indexed  sig,
                      address  indexed  usr,
                      bytes32  indexed  arg1,
                      bytes32  indexed  arg2,
                      bytes             data
                  ) anonymous;
              
                  modifier note {
                      _;
                      assembly {
                          // log an 'anonymous' event with a constant 6 words of calldata
                          // and four indexed topics: selector, caller, arg1 and arg2
                          let mark := msize                         // end of memory ensures zero
                          mstore(0x40, add(mark, 288))              // update free memory pointer
                          mstore(mark, 0x20)                        // bytes type data offset
                          mstore(add(mark, 0x20), 224)              // bytes size (padded)
                          calldatacopy(add(mark, 0x40), 0, 224)     // bytes payload
                          log4(mark, 288,                           // calldata
                               shl(224, shr(224, calldataload(0))), // msg.sig
                               caller,                              // msg.sender
                               calldataload(4),                     // arg1
                               calldataload(36)                     // arg2
                              )
                      }
                  }
              }
              
              ////// /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/dai.sol
              // Copyright (C) 2017, 2018, 2019 dbrock, rain, mrchico
              
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU Affero General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              //
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU Affero General Public License for more details.
              //
              // You should have received a copy of the GNU Affero General Public License
              // along with this program.  If not, see <https://www.gnu.org/licenses/>.
              
              /* pragma solidity 0.5.12; */
              
              /* import "./lib.sol"; */
              
              contract Dai is LibNote {
                  // --- Auth ---
                  mapping (address => uint) public wards;
                  function rely(address guy) external note auth { wards[guy] = 1; }
                  function deny(address guy) external note auth { wards[guy] = 0; }
                  modifier auth {
                      require(wards[msg.sender] == 1, "Dai/not-authorized");
                      _;
                  }
              
                  // --- ERC20 Data ---
                  string  public constant name     = "Dai Stablecoin";
                  string  public constant symbol   = "DAI";
                  string  public constant version  = "1";
                  uint8   public constant decimals = 18;
                  uint256 public totalSupply;
              
                  mapping (address => uint)                      public balanceOf;
                  mapping (address => mapping (address => uint)) public allowance;
                  mapping (address => uint)                      public nonces;
              
                  event Approval(address indexed src, address indexed guy, uint wad);
                  event Transfer(address indexed src, address indexed dst, uint wad);
              
                  // --- Math ---
                  function add(uint x, uint y) internal pure returns (uint z) {
                      require((z = x + y) >= x);
                  }
                  function sub(uint x, uint y) internal pure returns (uint z) {
                      require((z = x - y) <= x);
                  }
              
                  // --- EIP712 niceties ---
                  bytes32 public DOMAIN_SEPARATOR;
                  // bytes32 public constant PERMIT_TYPEHASH = keccak256("Permit(address holder,address spender,uint256 nonce,uint256 expiry,bool allowed)");
                  bytes32 public constant PERMIT_TYPEHASH = 0xea2aa0a1be11a07ed86d755c93467f4f82362b452371d1ba94d1715123511acb;
              
                  constructor(uint256 chainId_) public {
                      wards[msg.sender] = 1;
                      DOMAIN_SEPARATOR = keccak256(abi.encode(
                          keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"),
                          keccak256(bytes(name)),
                          keccak256(bytes(version)),
                          chainId_,
                          address(this)
                      ));
                  }
              
                  // --- Token ---
                  function transfer(address dst, uint wad) external returns (bool) {
                      return transferFrom(msg.sender, dst, wad);
                  }
                  function transferFrom(address src, address dst, uint wad)
                      public returns (bool)
                  {
                      require(balanceOf[src] >= wad, "Dai/insufficient-balance");
                      if (src != msg.sender && allowance[src][msg.sender] != uint(-1)) {
                          require(allowance[src][msg.sender] >= wad, "Dai/insufficient-allowance");
                          allowance[src][msg.sender] = sub(allowance[src][msg.sender], wad);
                      }
                      balanceOf[src] = sub(balanceOf[src], wad);
                      balanceOf[dst] = add(balanceOf[dst], wad);
                      emit Transfer(src, dst, wad);
                      return true;
                  }
                  function mint(address usr, uint wad) external auth {
                      balanceOf[usr] = add(balanceOf[usr], wad);
                      totalSupply    = add(totalSupply, wad);
                      emit Transfer(address(0), usr, wad);
                  }
                  function burn(address usr, uint wad) external {
                      require(balanceOf[usr] >= wad, "Dai/insufficient-balance");
                      if (usr != msg.sender && allowance[usr][msg.sender] != uint(-1)) {
                          require(allowance[usr][msg.sender] >= wad, "Dai/insufficient-allowance");
                          allowance[usr][msg.sender] = sub(allowance[usr][msg.sender], wad);
                      }
                      balanceOf[usr] = sub(balanceOf[usr], wad);
                      totalSupply    = sub(totalSupply, wad);
                      emit Transfer(usr, address(0), wad);
                  }
                  function approve(address usr, uint wad) external returns (bool) {
                      allowance[msg.sender][usr] = wad;
                      emit Approval(msg.sender, usr, wad);
                      return true;
                  }
              
                  // --- Alias ---
                  function push(address usr, uint wad) external {
                      transferFrom(msg.sender, usr, wad);
                  }
                  function pull(address usr, uint wad) external {
                      transferFrom(usr, msg.sender, wad);
                  }
                  function move(address src, address dst, uint wad) external {
                      transferFrom(src, dst, wad);
                  }
              
                  // --- Approve by signature ---
                  function permit(address holder, address spender, uint256 nonce, uint256 expiry,
                                  bool allowed, uint8 v, bytes32 r, bytes32 s) external
                  {
                      bytes32 digest =
                          keccak256(abi.encodePacked(
                              "\x19\x01",
                              DOMAIN_SEPARATOR,
                              keccak256(abi.encode(PERMIT_TYPEHASH,
                                                   holder,
                                                   spender,
                                                   nonce,
                                                   expiry,
                                                   allowed))
                      ));
              
                      require(holder != address(0), "Dai/invalid-address-0");
                      require(holder == ecrecover(digest, v, r, s), "Dai/invalid-permit");
                      require(expiry == 0 || now <= expiry, "Dai/permit-expired");
                      require(nonce == nonces[holder]++, "Dai/invalid-nonce");
                      uint wad = allowed ? uint(-1) : 0;
                      allowance[holder][spender] = wad;
                      emit Approval(holder, spender, wad);
                  }
              }

              File 2 of 9: DaiUsds
              // SPDX-License-Identifier: AGPL-3.0-or-later
              /// DaiUsds.sol -- Dai/Usds Exchanger
              // Copyright (C) 2023 Dai Foundation
              //
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU Affero General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              //
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU Affero General Public License for more details.
              //
              // You should have received a copy of the GNU Affero General Public License
              // along with this program.  If not, see <https://www.gnu.org/licenses/>.
              pragma solidity ^0.8.21;
              interface JoinLike {
                  function vat() external view returns (address);
                  function join(address, uint256) external;
                  function exit(address, uint256) external;
              }
              interface DaiJoinLike is JoinLike {
                  function dai() external view returns (address);
              }
              interface UsdsJoinLike is JoinLike {
                  function usds() external view returns (address);
              }
              interface GemLike {
                  function approve(address, uint256) external returns (bool);
                  function transferFrom(address, address, uint256) external returns (bool);
              }
              interface VatLike {
                  function hope(address) external;
              }
              contract DaiUsds {
                  DaiJoinLike  public immutable daiJoin;
                  UsdsJoinLike public immutable usdsJoin;
                  GemLike      public immutable dai;
                  GemLike      public immutable usds;
                  
                  event DaiToUsds(address indexed caller, address indexed usr, uint256 wad);
                  event UsdsToDai(address indexed caller, address indexed usr, uint256 wad);
                  constructor(address daiJoin_, address usdsJoin_) {
                      daiJoin  = DaiJoinLike(daiJoin_);
                      usdsJoin = UsdsJoinLike(usdsJoin_);
                      address vat = daiJoin.vat();
                      require(vat == usdsJoin.vat(), "DaiUsds/vat-not-same");
                      dai  = GemLike(daiJoin.dai());
                      usds = GemLike(usdsJoin.usds());
                      dai.approve(address(daiJoin), type(uint256).max);
                      usds.approve(address(usdsJoin), type(uint256).max);
                      VatLike(vat).hope(address(daiJoin));
                      VatLike(vat).hope(address(usdsJoin));
                  }
                  function daiToUsds(address usr, uint256 wad) external {
                      dai.transferFrom(msg.sender, address(this), wad);
                      daiJoin.join(address(this), wad);
                      usdsJoin.exit(usr, wad);
                      emit DaiToUsds(msg.sender, usr, wad);
                  }
                  function usdsToDai(address usr, uint256 wad) external {
                      usds.transferFrom(msg.sender, address(this), wad);
                      usdsJoin.join(address(this), wad);
                      daiJoin.exit(usr, wad);
                      emit UsdsToDai(msg.sender, usr, wad);
                  }
              }
              

              File 3 of 9: Vat
              // hevm: flattened sources of /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/vat.sol
              pragma solidity =0.5.12;
              
              ////// /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/vat.sol
              /// vat.sol -- Dai CDP database
              
              // Copyright (C) 2018 Rain <rainbreak@riseup.net>
              //
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU Affero General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              //
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU Affero General Public License for more details.
              //
              // You should have received a copy of the GNU Affero General Public License
              // along with this program.  If not, see <https://www.gnu.org/licenses/>.
              
              /* pragma solidity 0.5.12; */
              
              contract Vat {
                  // --- Auth ---
                  mapping (address => uint) public wards;
                  function rely(address usr) external note auth { require(live == 1, "Vat/not-live"); wards[usr] = 1; }
                  function deny(address usr) external note auth { require(live == 1, "Vat/not-live"); wards[usr] = 0; }
                  modifier auth {
                      require(wards[msg.sender] == 1, "Vat/not-authorized");
                      _;
                  }
              
                  mapping(address => mapping (address => uint)) public can;
                  function hope(address usr) external note { can[msg.sender][usr] = 1; }
                  function nope(address usr) external note { can[msg.sender][usr] = 0; }
                  function wish(address bit, address usr) internal view returns (bool) {
                      return either(bit == usr, can[bit][usr] == 1);
                  }
              
                  // --- Data ---
                  struct Ilk {
                      uint256 Art;   // Total Normalised Debt     [wad]
                      uint256 rate;  // Accumulated Rates         [ray]
                      uint256 spot;  // Price with Safety Margin  [ray]
                      uint256 line;  // Debt Ceiling              [rad]
                      uint256 dust;  // Urn Debt Floor            [rad]
                  }
                  struct Urn {
                      uint256 ink;   // Locked Collateral  [wad]
                      uint256 art;   // Normalised Debt    [wad]
                  }
              
                  mapping (bytes32 => Ilk)                       public ilks;
                  mapping (bytes32 => mapping (address => Urn )) public urns;
                  mapping (bytes32 => mapping (address => uint)) public gem;  // [wad]
                  mapping (address => uint256)                   public dai;  // [rad]
                  mapping (address => uint256)                   public sin;  // [rad]
              
                  uint256 public debt;  // Total Dai Issued    [rad]
                  uint256 public vice;  // Total Unbacked Dai  [rad]
                  uint256 public Line;  // Total Debt Ceiling  [rad]
                  uint256 public live;  // Access Flag
              
                  // --- Logs ---
                  event LogNote(
                      bytes4   indexed  sig,
                      bytes32  indexed  arg1,
                      bytes32  indexed  arg2,
                      bytes32  indexed  arg3,
                      bytes             data
                  ) anonymous;
              
                  modifier note {
                      _;
                      assembly {
                          // log an 'anonymous' event with a constant 6 words of calldata
                          // and four indexed topics: the selector and the first three args
                          let mark := msize                         // end of memory ensures zero
                          mstore(0x40, add(mark, 288))              // update free memory pointer
                          mstore(mark, 0x20)                        // bytes type data offset
                          mstore(add(mark, 0x20), 224)              // bytes size (padded)
                          calldatacopy(add(mark, 0x40), 0, 224)     // bytes payload
                          log4(mark, 288,                           // calldata
                               shl(224, shr(224, calldataload(0))), // msg.sig
                               calldataload(4),                     // arg1
                               calldataload(36),                    // arg2
                               calldataload(68)                     // arg3
                              )
                      }
                  }
              
                  // --- Init ---
                  constructor() public {
                      wards[msg.sender] = 1;
                      live = 1;
                  }
              
                  // --- Math ---
                  function add(uint x, int y) internal pure returns (uint z) {
                      z = x + uint(y);
                      require(y >= 0 || z <= x);
                      require(y <= 0 || z >= x);
                  }
                  function sub(uint x, int y) internal pure returns (uint z) {
                      z = x - uint(y);
                      require(y <= 0 || z <= x);
                      require(y >= 0 || z >= x);
                  }
                  function mul(uint x, int y) internal pure returns (int z) {
                      z = int(x) * y;
                      require(int(x) >= 0);
                      require(y == 0 || z / y == int(x));
                  }
                  function add(uint x, uint y) internal pure returns (uint z) {
                      require((z = x + y) >= x);
                  }
                  function sub(uint x, uint y) internal pure returns (uint z) {
                      require((z = x - y) <= x);
                  }
                  function mul(uint x, uint y) internal pure returns (uint z) {
                      require(y == 0 || (z = x * y) / y == x);
                  }
              
                  // --- Administration ---
                  function init(bytes32 ilk) external note auth {
                      require(ilks[ilk].rate == 0, "Vat/ilk-already-init");
                      ilks[ilk].rate = 10 ** 27;
                  }
                  function file(bytes32 what, uint data) external note auth {
                      require(live == 1, "Vat/not-live");
                      if (what == "Line") Line = data;
                      else revert("Vat/file-unrecognized-param");
                  }
                  function file(bytes32 ilk, bytes32 what, uint data) external note auth {
                      require(live == 1, "Vat/not-live");
                      if (what == "spot") ilks[ilk].spot = data;
                      else if (what == "line") ilks[ilk].line = data;
                      else if (what == "dust") ilks[ilk].dust = data;
                      else revert("Vat/file-unrecognized-param");
                  }
                  function cage() external note auth {
                      live = 0;
                  }
              
                  // --- Fungibility ---
                  function slip(bytes32 ilk, address usr, int256 wad) external note auth {
                      gem[ilk][usr] = add(gem[ilk][usr], wad);
                  }
                  function flux(bytes32 ilk, address src, address dst, uint256 wad) external note {
                      require(wish(src, msg.sender), "Vat/not-allowed");
                      gem[ilk][src] = sub(gem[ilk][src], wad);
                      gem[ilk][dst] = add(gem[ilk][dst], wad);
                  }
                  function move(address src, address dst, uint256 rad) external note {
                      require(wish(src, msg.sender), "Vat/not-allowed");
                      dai[src] = sub(dai[src], rad);
                      dai[dst] = add(dai[dst], rad);
                  }
              
                  function either(bool x, bool y) internal pure returns (bool z) {
                      assembly{ z := or(x, y)}
                  }
                  function both(bool x, bool y) internal pure returns (bool z) {
                      assembly{ z := and(x, y)}
                  }
              
                  // --- CDP Manipulation ---
                  function frob(bytes32 i, address u, address v, address w, int dink, int dart) external note {
                      // system is live
                      require(live == 1, "Vat/not-live");
              
                      Urn memory urn = urns[i][u];
                      Ilk memory ilk = ilks[i];
                      // ilk has been initialised
                      require(ilk.rate != 0, "Vat/ilk-not-init");
              
                      urn.ink = add(urn.ink, dink);
                      urn.art = add(urn.art, dart);
                      ilk.Art = add(ilk.Art, dart);
              
                      int dtab = mul(ilk.rate, dart);
                      uint tab = mul(ilk.rate, urn.art);
                      debt     = add(debt, dtab);
              
                      // either debt has decreased, or debt ceilings are not exceeded
                      require(either(dart <= 0, both(mul(ilk.Art, ilk.rate) <= ilk.line, debt <= Line)), "Vat/ceiling-exceeded");
                      // urn is either less risky than before, or it is safe
                      require(either(both(dart <= 0, dink >= 0), tab <= mul(urn.ink, ilk.spot)), "Vat/not-safe");
              
                      // urn is either more safe, or the owner consents
                      require(either(both(dart <= 0, dink >= 0), wish(u, msg.sender)), "Vat/not-allowed-u");
                      // collateral src consents
                      require(either(dink <= 0, wish(v, msg.sender)), "Vat/not-allowed-v");
                      // debt dst consents
                      require(either(dart >= 0, wish(w, msg.sender)), "Vat/not-allowed-w");
              
                      // urn has no debt, or a non-dusty amount
                      require(either(urn.art == 0, tab >= ilk.dust), "Vat/dust");
              
                      gem[i][v] = sub(gem[i][v], dink);
                      dai[w]    = add(dai[w],    dtab);
              
                      urns[i][u] = urn;
                      ilks[i]    = ilk;
                  }
                  // --- CDP Fungibility ---
                  function fork(bytes32 ilk, address src, address dst, int dink, int dart) external note {
                      Urn storage u = urns[ilk][src];
                      Urn storage v = urns[ilk][dst];
                      Ilk storage i = ilks[ilk];
              
                      u.ink = sub(u.ink, dink);
                      u.art = sub(u.art, dart);
                      v.ink = add(v.ink, dink);
                      v.art = add(v.art, dart);
              
                      uint utab = mul(u.art, i.rate);
                      uint vtab = mul(v.art, i.rate);
              
                      // both sides consent
                      require(both(wish(src, msg.sender), wish(dst, msg.sender)), "Vat/not-allowed");
              
                      // both sides safe
                      require(utab <= mul(u.ink, i.spot), "Vat/not-safe-src");
                      require(vtab <= mul(v.ink, i.spot), "Vat/not-safe-dst");
              
                      // both sides non-dusty
                      require(either(utab >= i.dust, u.art == 0), "Vat/dust-src");
                      require(either(vtab >= i.dust, v.art == 0), "Vat/dust-dst");
                  }
                  // --- CDP Confiscation ---
                  function grab(bytes32 i, address u, address v, address w, int dink, int dart) external note auth {
                      Urn storage urn = urns[i][u];
                      Ilk storage ilk = ilks[i];
              
                      urn.ink = add(urn.ink, dink);
                      urn.art = add(urn.art, dart);
                      ilk.Art = add(ilk.Art, dart);
              
                      int dtab = mul(ilk.rate, dart);
              
                      gem[i][v] = sub(gem[i][v], dink);
                      sin[w]    = sub(sin[w],    dtab);
                      vice      = sub(vice,      dtab);
                  }
              
                  // --- Settlement ---
                  function heal(uint rad) external note {
                      address u = msg.sender;
                      sin[u] = sub(sin[u], rad);
                      dai[u] = sub(dai[u], rad);
                      vice   = sub(vice,   rad);
                      debt   = sub(debt,   rad);
                  }
                  function suck(address u, address v, uint rad) external note auth {
                      sin[u] = add(sin[u], rad);
                      dai[v] = add(dai[v], rad);
                      vice   = add(vice,   rad);
                      debt   = add(debt,   rad);
                  }
              
                  // --- Rates ---
                  function fold(bytes32 i, address u, int rate) external note auth {
                      require(live == 1, "Vat/not-live");
                      Ilk storage ilk = ilks[i];
                      ilk.rate = add(ilk.rate, rate);
                      int rad  = mul(ilk.Art, rate);
                      dai[u]   = add(dai[u], rad);
                      debt     = add(debt,   rad);
                  }
              }

              File 4 of 9: DaiJoin
              // hevm: flattened sources of /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/join.sol
              pragma solidity =0.5.12;
              
              ////// /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/lib.sol
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU General Public License for more details.
              
              // You should have received a copy of the GNU General Public License
              // along with this program.  If not, see <http://www.gnu.org/licenses/>.
              
              /* pragma solidity 0.5.12; */
              
              contract LibNote {
                  event LogNote(
                      bytes4   indexed  sig,
                      address  indexed  usr,
                      bytes32  indexed  arg1,
                      bytes32  indexed  arg2,
                      bytes             data
                  ) anonymous;
              
                  modifier note {
                      _;
                      assembly {
                          // log an 'anonymous' event with a constant 6 words of calldata
                          // and four indexed topics: selector, caller, arg1 and arg2
                          let mark := msize                         // end of memory ensures zero
                          mstore(0x40, add(mark, 288))              // update free memory pointer
                          mstore(mark, 0x20)                        // bytes type data offset
                          mstore(add(mark, 0x20), 224)              // bytes size (padded)
                          calldatacopy(add(mark, 0x40), 0, 224)     // bytes payload
                          log4(mark, 288,                           // calldata
                               shl(224, shr(224, calldataload(0))), // msg.sig
                               caller,                              // msg.sender
                               calldataload(4),                     // arg1
                               calldataload(36)                     // arg2
                              )
                      }
                  }
              }
              
              ////// /nix/store/8xb41r4qd0cjb63wcrxf1qmfg88p0961-dss-6fd7de0/src/join.sol
              /// join.sol -- Basic token adapters
              
              // Copyright (C) 2018 Rain <rainbreak@riseup.net>
              //
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU Affero General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              //
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU Affero General Public License for more details.
              //
              // You should have received a copy of the GNU Affero General Public License
              // along with this program.  If not, see <https://www.gnu.org/licenses/>.
              
              /* pragma solidity 0.5.12; */
              
              /* import "./lib.sol"; */
              
              contract GemLike {
                  function decimals() public view returns (uint);
                  function transfer(address,uint) external returns (bool);
                  function transferFrom(address,address,uint) external returns (bool);
              }
              
              contract DSTokenLike {
                  function mint(address,uint) external;
                  function burn(address,uint) external;
              }
              
              contract VatLike {
                  function slip(bytes32,address,int) external;
                  function move(address,address,uint) external;
              }
              
              /*
                  Here we provide *adapters* to connect the Vat to arbitrary external
                  token implementations, creating a bounded context for the Vat. The
                  adapters here are provided as working examples:
              
                    - `GemJoin`: For well behaved ERC20 tokens, with simple transfer
                                 semantics.
              
                    - `ETHJoin`: For native Ether.
              
                    - `DaiJoin`: For connecting internal Dai balances to an external
                                 `DSToken` implementation.
              
                  In practice, adapter implementations will be varied and specific to
                  individual collateral types, accounting for different transfer
                  semantics and token standards.
              
                  Adapters need to implement two basic methods:
              
                    - `join`: enter collateral into the system
                    - `exit`: remove collateral from the system
              
              */
              
              contract GemJoin is LibNote {
                  // --- Auth ---
                  mapping (address => uint) public wards;
                  function rely(address usr) external note auth { wards[usr] = 1; }
                  function deny(address usr) external note auth { wards[usr] = 0; }
                  modifier auth {
                      require(wards[msg.sender] == 1, "GemJoin/not-authorized");
                      _;
                  }
              
                  VatLike public vat;
                  bytes32 public ilk;
                  GemLike public gem;
                  uint    public dec;
                  uint    public live;  // Access Flag
              
                  constructor(address vat_, bytes32 ilk_, address gem_) public {
                      wards[msg.sender] = 1;
                      live = 1;
                      vat = VatLike(vat_);
                      ilk = ilk_;
                      gem = GemLike(gem_);
                      dec = gem.decimals();
                  }
                  function cage() external note auth {
                      live = 0;
                  }
                  function join(address usr, uint wad) external note {
                      require(live == 1, "GemJoin/not-live");
                      require(int(wad) >= 0, "GemJoin/overflow");
                      vat.slip(ilk, usr, int(wad));
                      require(gem.transferFrom(msg.sender, address(this), wad), "GemJoin/failed-transfer");
                  }
                  function exit(address usr, uint wad) external note {
                      require(wad <= 2 ** 255, "GemJoin/overflow");
                      vat.slip(ilk, msg.sender, -int(wad));
                      require(gem.transfer(usr, wad), "GemJoin/failed-transfer");
                  }
              }
              
              contract ETHJoin is LibNote {
                  // --- Auth ---
                  mapping (address => uint) public wards;
                  function rely(address usr) external note auth { wards[usr] = 1; }
                  function deny(address usr) external note auth { wards[usr] = 0; }
                  modifier auth {
                      require(wards[msg.sender] == 1, "ETHJoin/not-authorized");
                      _;
                  }
              
                  VatLike public vat;
                  bytes32 public ilk;
                  uint    public live;  // Access Flag
              
                  constructor(address vat_, bytes32 ilk_) public {
                      wards[msg.sender] = 1;
                      live = 1;
                      vat = VatLike(vat_);
                      ilk = ilk_;
                  }
                  function cage() external note auth {
                      live = 0;
                  }
                  function join(address usr) external payable note {
                      require(live == 1, "ETHJoin/not-live");
                      require(int(msg.value) >= 0, "ETHJoin/overflow");
                      vat.slip(ilk, usr, int(msg.value));
                  }
                  function exit(address payable usr, uint wad) external note {
                      require(int(wad) >= 0, "ETHJoin/overflow");
                      vat.slip(ilk, msg.sender, -int(wad));
                      usr.transfer(wad);
                  }
              }
              
              contract DaiJoin is LibNote {
                  // --- Auth ---
                  mapping (address => uint) public wards;
                  function rely(address usr) external note auth { wards[usr] = 1; }
                  function deny(address usr) external note auth { wards[usr] = 0; }
                  modifier auth {
                      require(wards[msg.sender] == 1, "DaiJoin/not-authorized");
                      _;
                  }
              
                  VatLike public vat;
                  DSTokenLike public dai;
                  uint    public live;  // Access Flag
              
                  constructor(address vat_, address dai_) public {
                      wards[msg.sender] = 1;
                      live = 1;
                      vat = VatLike(vat_);
                      dai = DSTokenLike(dai_);
                  }
                  function cage() external note auth {
                      live = 0;
                  }
                  uint constant ONE = 10 ** 27;
                  function mul(uint x, uint y) internal pure returns (uint z) {
                      require(y == 0 || (z = x * y) / y == x);
                  }
                  function join(address usr, uint wad) external note {
                      vat.move(address(this), usr, mul(ONE, wad));
                      dai.burn(msg.sender, wad);
                  }
                  function exit(address usr, uint wad) external note {
                      require(live == 1, "DaiJoin/not-live");
                      vat.move(msg.sender, address(this), mul(ONE, wad));
                      dai.mint(usr, wad);
                  }
              }

              File 5 of 9: ERC1967Proxy
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Proxy.sol)
              pragma solidity ^0.8.20;
              import {Proxy} from "../Proxy.sol";
              import {ERC1967Utils} from "./ERC1967Utils.sol";
              /**
               * @dev This contract implements an upgradeable proxy. It is upgradeable because calls are delegated to an
               * implementation address that can be changed. This address is stored in storage in the location specified by
               * https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the
               * implementation behind the proxy.
               */
              contract ERC1967Proxy is Proxy {
                  /**
                   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation`.
                   *
                   * If `_data` is nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
                   * encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
                   *
                   * Requirements:
                   *
                   * - If `data` is empty, `msg.value` must be zero.
                   */
                  constructor(address implementation, bytes memory _data) payable {
                      ERC1967Utils.upgradeToAndCall(implementation, _data);
                  }
                  /**
                   * @dev Returns the current implementation address.
                   *
                   * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using
                   * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                   * `0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc`
                   */
                  function _implementation() internal view virtual override returns (address) {
                      return ERC1967Utils.getImplementation();
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/Proxy.sol)
              pragma solidity ^0.8.20;
              /**
               * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM
               * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to
               * be specified by overriding the virtual {_implementation} function.
               *
               * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a
               * different contract through the {_delegate} function.
               *
               * The success and return data of the delegated call will be returned back to the caller of the proxy.
               */
              abstract contract Proxy {
                  /**
                   * @dev Delegates the current call to `implementation`.
                   *
                   * This function does not return to its internal call site, it will return directly to the external caller.
                   */
                  function _delegate(address implementation) internal virtual {
                      assembly {
                          // Copy msg.data. We take full control of memory in this inline assembly
                          // block because it will not return to Solidity code. We overwrite the
                          // Solidity scratch pad at memory position 0.
                          calldatacopy(0, 0, calldatasize())
                          // Call the implementation.
                          // out and outsize are 0 because we don't know the size yet.
                          let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)
                          // Copy the returned data.
                          returndatacopy(0, 0, returndatasize())
                          switch result
                          // delegatecall returns 0 on error.
                          case 0 {
                              revert(0, returndatasize())
                          }
                          default {
                              return(0, returndatasize())
                          }
                      }
                  }
                  /**
                   * @dev This is a virtual function that should be overridden so it returns the address to which the fallback
                   * function and {_fallback} should delegate.
                   */
                  function _implementation() internal view virtual returns (address);
                  /**
                   * @dev Delegates the current call to the address returned by `_implementation()`.
                   *
                   * This function does not return to its internal call site, it will return directly to the external caller.
                   */
                  function _fallback() internal virtual {
                      _delegate(_implementation());
                  }
                  /**
                   * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other
                   * function in the contract matches the call data.
                   */
                  fallback() external payable virtual {
                      _fallback();
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)
              pragma solidity ^0.8.20;
              import {IBeacon} from "../beacon/IBeacon.sol";
              import {Address} from "../../utils/Address.sol";
              import {StorageSlot} from "../../utils/StorageSlot.sol";
              /**
               * @dev This abstract contract provides getters and event emitting update functions for
               * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
               */
              library ERC1967Utils {
                  // We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
                  // This will be fixed in Solidity 0.8.21. At that point we should remove these events.
                  /**
                   * @dev Emitted when the implementation is upgraded.
                   */
                  event Upgraded(address indexed implementation);
                  /**
                   * @dev Emitted when the admin account has changed.
                   */
                  event AdminChanged(address previousAdmin, address newAdmin);
                  /**
                   * @dev Emitted when the beacon is changed.
                   */
                  event BeaconUpgraded(address indexed beacon);
                  /**
                   * @dev Storage slot with the address of the current implementation.
                   * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
                  /**
                   * @dev The `implementation` of the proxy is invalid.
                   */
                  error ERC1967InvalidImplementation(address implementation);
                  /**
                   * @dev The `admin` of the proxy is invalid.
                   */
                  error ERC1967InvalidAdmin(address admin);
                  /**
                   * @dev The `beacon` of the proxy is invalid.
                   */
                  error ERC1967InvalidBeacon(address beacon);
                  /**
                   * @dev An upgrade function sees `msg.value > 0` that may be lost.
                   */
                  error ERC1967NonPayable();
                  /**
                   * @dev Returns the current implementation address.
                   */
                  function getImplementation() internal view returns (address) {
                      return StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value;
                  }
                  /**
                   * @dev Stores a new address in the EIP1967 implementation slot.
                   */
                  function _setImplementation(address newImplementation) private {
                      if (newImplementation.code.length == 0) {
                          revert ERC1967InvalidImplementation(newImplementation);
                      }
                      StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
                  }
                  /**
                   * @dev Performs implementation upgrade with additional setup call if data is nonempty.
                   * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                   * to avoid stuck value in the contract.
                   *
                   * Emits an {IERC1967-Upgraded} event.
                   */
                  function upgradeToAndCall(address newImplementation, bytes memory data) internal {
                      _setImplementation(newImplementation);
                      emit Upgraded(newImplementation);
                      if (data.length > 0) {
                          Address.functionDelegateCall(newImplementation, data);
                      } else {
                          _checkNonPayable();
                      }
                  }
                  /**
                   * @dev Storage slot with the admin of the contract.
                   * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
                  /**
                   * @dev Returns the current admin.
                   *
                   * TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using
                   * the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
                   * `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
                   */
                  function getAdmin() internal view returns (address) {
                      return StorageSlot.getAddressSlot(ADMIN_SLOT).value;
                  }
                  /**
                   * @dev Stores a new address in the EIP1967 admin slot.
                   */
                  function _setAdmin(address newAdmin) private {
                      if (newAdmin == address(0)) {
                          revert ERC1967InvalidAdmin(address(0));
                      }
                      StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
                  }
                  /**
                   * @dev Changes the admin of the proxy.
                   *
                   * Emits an {IERC1967-AdminChanged} event.
                   */
                  function changeAdmin(address newAdmin) internal {
                      emit AdminChanged(getAdmin(), newAdmin);
                      _setAdmin(newAdmin);
                  }
                  /**
                   * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
                   * This is the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
                   */
                  // solhint-disable-next-line private-vars-leading-underscore
                  bytes32 internal constant BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
                  /**
                   * @dev Returns the current beacon.
                   */
                  function getBeacon() internal view returns (address) {
                      return StorageSlot.getAddressSlot(BEACON_SLOT).value;
                  }
                  /**
                   * @dev Stores a new beacon in the EIP1967 beacon slot.
                   */
                  function _setBeacon(address newBeacon) private {
                      if (newBeacon.code.length == 0) {
                          revert ERC1967InvalidBeacon(newBeacon);
                      }
                      StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;
                      address beaconImplementation = IBeacon(newBeacon).implementation();
                      if (beaconImplementation.code.length == 0) {
                          revert ERC1967InvalidImplementation(beaconImplementation);
                      }
                  }
                  /**
                   * @dev Change the beacon and trigger a setup call if data is nonempty.
                   * This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
                   * to avoid stuck value in the contract.
                   *
                   * Emits an {IERC1967-BeaconUpgraded} event.
                   *
                   * CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
                   * it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
                   * efficiency.
                   */
                  function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
                      _setBeacon(newBeacon);
                      emit BeaconUpgraded(newBeacon);
                      if (data.length > 0) {
                          Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
                      } else {
                          _checkNonPayable();
                      }
                  }
                  /**
                   * @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
                   * if an upgrade doesn't perform an initialization call.
                   */
                  function _checkNonPayable() private {
                      if (msg.value > 0) {
                          revert ERC1967NonPayable();
                      }
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)
              pragma solidity ^0.8.20;
              /**
               * @dev This is the interface that {BeaconProxy} expects of its beacon.
               */
              interface IBeacon {
                  /**
                   * @dev Must return an address that can be used as a delegate call target.
                   *
                   * {UpgradeableBeacon} will check that this address is a contract.
                   */
                  function implementation() external view returns (address);
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
              pragma solidity ^0.8.20;
              /**
               * @dev Collection of functions related to the address type
               */
              library Address {
                  /**
                   * @dev The ETH balance of the account is not enough to perform the operation.
                   */
                  error AddressInsufficientBalance(address account);
                  /**
                   * @dev There's no code at `target` (it is not a contract).
                   */
                  error AddressEmptyCode(address target);
                  /**
                   * @dev A call to an address target failed. The target may have reverted.
                   */
                  error FailedInnerCall();
                  /**
                   * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
                   * `recipient`, forwarding all available gas and reverting on errors.
                   *
                   * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
                   * of certain opcodes, possibly making contracts go over the 2300 gas limit
                   * imposed by `transfer`, making them unable to receive funds via
                   * `transfer`. {sendValue} removes this limitation.
                   *
                   * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
                   *
                   * IMPORTANT: because control is transferred to `recipient`, care must be
                   * taken to not create reentrancy vulnerabilities. Consider using
                   * {ReentrancyGuard} or the
                   * https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
                   */
                  function sendValue(address payable recipient, uint256 amount) internal {
                      if (address(this).balance < amount) {
                          revert AddressInsufficientBalance(address(this));
                      }
                      (bool success, ) = recipient.call{value: amount}("");
                      if (!success) {
                          revert FailedInnerCall();
                      }
                  }
                  /**
                   * @dev Performs a Solidity function call using a low level `call`. A
                   * plain `call` is an unsafe replacement for a function call: use this
                   * function instead.
                   *
                   * If `target` reverts with a revert reason or custom error, it is bubbled
                   * up by this function (like regular Solidity function calls). However, if
                   * the call reverted with no returned reason, this function reverts with a
                   * {FailedInnerCall} error.
                   *
                   * Returns the raw returned data. To convert to the expected return value,
                   * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
                   *
                   * Requirements:
                   *
                   * - `target` must be a contract.
                   * - calling `target` with `data` must not revert.
                   */
                  function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                      return functionCallWithValue(target, data, 0);
                  }
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but also transferring `value` wei to `target`.
                   *
                   * Requirements:
                   *
                   * - the calling contract must have an ETH balance of at least `value`.
                   * - the called Solidity function must be `payable`.
                   */
                  function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
                      if (address(this).balance < value) {
                          revert AddressInsufficientBalance(address(this));
                      }
                      (bool success, bytes memory returndata) = target.call{value: value}(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but performing a static call.
                   */
                  function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
                      (bool success, bytes memory returndata) = target.staticcall(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
                  /**
                   * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
                   * but performing a delegate call.
                   */
                  function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
                      (bool success, bytes memory returndata) = target.delegatecall(data);
                      return verifyCallResultFromTarget(target, success, returndata);
                  }
                  /**
                   * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
                   * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
                   * unsuccessful call.
                   */
                  function verifyCallResultFromTarget(
                      address target,
                      bool success,
                      bytes memory returndata
                  ) internal view returns (bytes memory) {
                      if (!success) {
                          _revert(returndata);
                      } else {
                          // only check if target is a contract if the call was successful and the return data is empty
                          // otherwise we already know that it was a contract
                          if (returndata.length == 0 && target.code.length == 0) {
                              revert AddressEmptyCode(target);
                          }
                          return returndata;
                      }
                  }
                  /**
                   * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
                   * revert reason or with a default {FailedInnerCall} error.
                   */
                  function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
                      if (!success) {
                          _revert(returndata);
                      } else {
                          return returndata;
                      }
                  }
                  /**
                   * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
                   */
                  function _revert(bytes memory returndata) private pure {
                      // Look for revert reason and bubble it up if present
                      if (returndata.length > 0) {
                          // The easiest way to bubble the revert reason is using memory via assembly
                          /// @solidity memory-safe-assembly
                          assembly {
                              let returndata_size := mload(returndata)
                              revert(add(32, returndata), returndata_size)
                          }
                      } else {
                          revert FailedInnerCall();
                      }
                  }
              }
              // SPDX-License-Identifier: MIT
              // OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
              // This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
              pragma solidity ^0.8.20;
              /**
               * @dev Library for reading and writing primitive types to specific storage slots.
               *
               * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
               * This library helps with reading and writing to such slots without the need for inline assembly.
               *
               * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
               *
               * Example usage to set ERC1967 implementation slot:
               * ```solidity
               * contract ERC1967 {
               *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
               *
               *     function _getImplementation() internal view returns (address) {
               *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
               *     }
               *
               *     function _setImplementation(address newImplementation) internal {
               *         require(newImplementation.code.length > 0);
               *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
               *     }
               * }
               * ```
               */
              library StorageSlot {
                  struct AddressSlot {
                      address value;
                  }
                  struct BooleanSlot {
                      bool value;
                  }
                  struct Bytes32Slot {
                      bytes32 value;
                  }
                  struct Uint256Slot {
                      uint256 value;
                  }
                  struct StringSlot {
                      string value;
                  }
                  struct BytesSlot {
                      bytes value;
                  }
                  /**
                   * @dev Returns an `AddressSlot` with member `value` located at `slot`.
                   */
                  function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
                   */
                  function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
                   */
                  function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
                   */
                  function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `StringSlot` with member `value` located at `slot`.
                   */
                  function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
                   */
                  function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := store.slot
                      }
                  }
                  /**
                   * @dev Returns an `BytesSlot` with member `value` located at `slot`.
                   */
                  function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := slot
                      }
                  }
                  /**
                   * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
                   */
                  function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
                      /// @solidity memory-safe-assembly
                      assembly {
                          r.slot := store.slot
                      }
                  }
              }
              

              File 6 of 9: UsdsJoin
              // SPDX-License-Identifier: AGPL-3.0-or-later
              /// UsdsJoin.sol -- Usds adapter
              // Copyright (C) 2018 Rain <rainbreak@riseup.net>
              // Copyright (C) 2023 Dai Foundation
              //
              // This program is free software: you can redistribute it and/or modify
              // it under the terms of the GNU Affero General Public License as published by
              // the Free Software Foundation, either version 3 of the License, or
              // (at your option) any later version.
              //
              // This program is distributed in the hope that it will be useful,
              // but WITHOUT ANY WARRANTY; without even the implied warranty of
              // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
              // GNU Affero General Public License for more details.
              //
              // You should have received a copy of the GNU Affero General Public License
              // along with this program.  If not, see <https://www.gnu.org/licenses/>.
              pragma solidity ^0.8.21;
              interface UsdsLike {
                  function burn(address,uint256) external;
                  function mint(address,uint256) external;
              }
              interface VatLike {
                  function move(address,address,uint256) external;
              }
              contract UsdsJoin {
                  VatLike  public immutable vat;  // CDP Engine
                  UsdsLike public immutable usds; // Stablecoin Token
                  uint256 constant RAY = 10 ** 27;
                  // --- Events ---
                  event Join(address indexed caller, address indexed usr, uint256 wad);
                  event Exit(address indexed caller, address indexed usr, uint256 wad);
                  constructor(address vat_, address usds_) {
                      vat  = VatLike(vat_);
                      usds = UsdsLike(usds_);
                  }
                  function join(address usr, uint256 wad) external {
                      vat.move(address(this), usr, RAY * wad);
                      usds.burn(msg.sender, wad);
                      emit Join(msg.sender, usr, wad);
                  }
                  function exit(address usr, uint256 wad) external {
                      vat.move(msg.sender, address(this), RAY * wad);
                      usds.mint(usr, wad);
                      emit Exit(msg.sender, usr, wad);
                  }
                  // To fully cover daiJoin abi
                  function dai() external view returns (address) {
                      return address(usds);
                  }
              }
              

              File 7 of 9: DefisaverLogger
              // SPDX-License-Identifier: MIT
              
              pragma solidity =0.8.10;
              
              contract DefisaverLogger {
                  event RecipeEvent(
                      address indexed caller,
                      string indexed logName
                  );
              
                  event ActionDirectEvent(
                      address indexed caller,
                      string indexed logName,
                      bytes data
                  );
              
                  function logRecipeEvent(
                      string memory _logName
                  ) public {
                      emit RecipeEvent(msg.sender, _logName);
                  }
              
                  function logActionDirectEvent(
                      string memory _logName,
                      bytes memory _data
                  ) public {
                      emit ActionDirectEvent(msg.sender, _logName, _data);
                  }
              }

              File 8 of 9: McdTokenConverter
              // SPDX-License-Identifier: MIT
              pragma solidity =0.8.24;
              
              
              
              
              
              
              
              
              
              
              contract MainnetActionsUtilAddresses {
                  address internal constant DFS_REG_CONTROLLER_ADDR = 0xF8f8B3C98Cf2E63Df3041b73f80F362a4cf3A576;
                  address internal constant REGISTRY_ADDR = 0x287778F121F134C66212FB16c9b53eC991D32f5b;
                  address internal constant DFS_LOGGER_ADDR = 0xcE7a977Cac4a481bc84AC06b2Da0df614e621cf3;
                  address internal constant SUB_STORAGE_ADDR = 0x1612fc28Ee0AB882eC99842Cde0Fc77ff0691e90;
                  address internal constant PROXY_AUTH_ADDR = 0x149667b6FAe2c63D1B4317C716b0D0e4d3E2bD70;
                  address internal constant LSV_PROXY_REGISTRY_ADDRESS = 0xa8a3c86c4A2DcCf350E84D2b3c46BDeBc711C16e;
                  address internal constant TRANSIENT_STORAGE = 0x2F7Ef2ea5E8c97B8687CA703A0e50Aa5a49B7eb2;
              }
              
              
              
              
              
              
              
              contract ActionsUtilHelper is MainnetActionsUtilAddresses {
              }
              
              
              
              
              
              
              
              contract MainnetAuthAddresses {
                  address internal constant ADMIN_VAULT_ADDR = 0xCCf3d848e08b94478Ed8f46fFead3008faF581fD;
                  address internal constant DSGUARD_FACTORY_ADDRESS = 0x5a15566417e6C1c9546523066500bDDBc53F88C7;
                  address internal constant ADMIN_ADDR = 0x25eFA336886C74eA8E282ac466BdCd0199f85BB9; // USED IN ADMIN VAULT CONSTRUCTOR
                  address internal constant PROXY_AUTH_ADDRESS = 0x149667b6FAe2c63D1B4317C716b0D0e4d3E2bD70;
                  address internal constant MODULE_AUTH_ADDRESS = 0x7407974DDBF539e552F1d051e44573090912CC3D;
              }
              
              
              
              
              
              
              
              contract AuthHelper is MainnetAuthAddresses {
              }
              
              
              
              
              
              
              
              
              contract AdminVault is AuthHelper {
                  address public owner;
                  address public admin;
              
                  error SenderNotAdmin();
              
                  constructor() {
                      owner = msg.sender;
                      admin = ADMIN_ADDR;
                  }
              
                  /// @notice Admin is able to change owner
                  /// @param _owner Address of new owner
                  function changeOwner(address _owner) public {
                      if (admin != msg.sender){
                          revert SenderNotAdmin();
                      }
                      owner = _owner;
                  }
              
                  /// @notice Admin is able to set new admin
                  /// @param _admin Address of multisig that becomes new admin
                  function changeAdmin(address _admin) public {
                      if (admin != msg.sender){
                          revert SenderNotAdmin();
                      }
                      admin = _admin;
                  }
              
              }
              
              
              
              
              
              
              
              interface IERC20 {
                  function name() external view returns (string memory);
                  function symbol() external view returns (string memory);
                  function decimals() external view returns (uint256 digits);
                  function totalSupply() external view returns (uint256 supply);
              
                  function balanceOf(address _owner) external view returns (uint256 balance);
              
                  function transfer(address _to, uint256 _value) external returns (bool success);
              
                  function transferFrom(
                      address _from,
                      address _to,
                      uint256 _value
                  ) external returns (bool success);
              
                  function approve(address _spender, uint256 _value) external returns (bool success);
              
                  function allowance(address _owner, address _spender) external view returns (uint256 remaining);
              
                  event Approval(address indexed _owner, address indexed _spender, uint256 _value);
              }
              
              
              
              
              
              
              
              library Address {
                  //insufficient balance
                  error InsufficientBalance(uint256 available, uint256 required);
                  //unable to send value, recipient may have reverted
                  error SendingValueFail();
                  //insufficient balance for call
                  error InsufficientBalanceForCall(uint256 available, uint256 required);
                  //call to non-contract
                  error NonContractCall();
                  
                  function isContract(address account) internal view returns (bool) {
                      // According to EIP-1052, 0x0 is the value returned for not-yet created accounts
                      // and 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 is returned
                      // for accounts without code, i.e. `keccak256('')`
                      bytes32 codehash;
                      bytes32 accountHash = 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470;
                      // solhint-disable-next-line no-inline-assembly
                      assembly {
                          codehash := extcodehash(account)
                      }
                      return (codehash != accountHash && codehash != 0x0);
                  }
              
                  function sendValue(address payable recipient, uint256 amount) internal {
                      uint256 balance = address(this).balance;
                      if (balance < amount){
                          revert InsufficientBalance(balance, amount);
                      }
              
                      // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
                      (bool success, ) = recipient.call{value: amount}("");
                      if (!(success)){
                          revert SendingValueFail();
                      }
                  }
              
                  function functionCall(address target, bytes memory data) internal returns (bytes memory) {
                      return functionCall(target, data, "Address: low-level call failed");
                  }
              
                  function functionCall(
                      address target,
                      bytes memory data,
                      string memory errorMessage
                  ) internal returns (bytes memory) {
                      return _functionCallWithValue(target, data, 0, errorMessage);
                  }
              
                  function functionCallWithValue(
                      address target,
                      bytes memory data,
                      uint256 value
                  ) internal returns (bytes memory) {
                      return
                          functionCallWithValue(target, data, value, "Address: low-level call with value failed");
                  }
              
                  function functionCallWithValue(
                      address target,
                      bytes memory data,
                      uint256 value,
                      string memory errorMessage
                  ) internal returns (bytes memory) {
                      uint256 balance = address(this).balance;
                      if (balance < value){
                          revert InsufficientBalanceForCall(balance, value);
                      }
                      return _functionCallWithValue(target, data, value, errorMessage);
                  }
              
                  function _functionCallWithValue(
                      address target,
                      bytes memory data,
                      uint256 weiValue,
                      string memory errorMessage
                  ) private returns (bytes memory) {
                      if (!(isContract(target))){
                          revert NonContractCall();
                      }
              
                      // solhint-disable-next-line avoid-low-level-calls
                      (bool success, bytes memory returndata) = target.call{value: weiValue}(data);
                      if (success) {
                          return returndata;
                      } else {
                          // Look for revert reason and bubble it up if present
                          if (returndata.length > 0) {
                              // The easiest way to bubble the revert reason is using memory via assembly
              
                              // solhint-disable-next-line no-inline-assembly
                              assembly {
                                  let returndata_size := mload(returndata)
                                  revert(add(32, returndata), returndata_size)
                              }
                          } else {
                              revert(errorMessage);
                          }
                      }
                  }
              }
              
              
              
              
              
              
              
              
              
              
              
              library SafeERC20 {
                  using Address for address;
              
                  /**
                   * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
                   * non-reverting calls are assumed to be successful.
                   */
                  function safeTransfer(IERC20 token, address to, uint256 value) internal {
                      _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
                  }
              
                  /**
                   * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
                   * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
                   */
                  function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
                      _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
                  }
              
                  /**
                   * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
                   * non-reverting calls are assumed to be successful. Compatible with tokens that require the approval to be set to
                   * 0 before setting it to a non-zero value.
                   */
                  function safeApprove(IERC20 token, address spender, uint256 value) internal {
                      bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);
              
                      if (!_callOptionalReturnBool(token, approvalCall)) {
                          _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));
                          _callOptionalReturn(token, approvalCall);
                      }
                  }
              
                  /**
                   * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                   * on the return value: the return value is optional (but if data is returned, it must not be false).
                   * @param token The token targeted by the call.
                   * @param data The call data (encoded using abi.encode or one of its variants).
                   */
                  function _callOptionalReturn(IERC20 token, bytes memory data) private {
                      // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                      // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
                      // the target address contains contract code and also asserts for success in the low-level call.
              
                      bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
                      require(returndata.length == 0 || abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
                  }
              
                  /**
                   * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
                   * on the return value: the return value is optional (but if data is returned, it must not be false).
                   * @param token The token targeted by the call.
                   * @param data The call data (encoded using abi.encode or one of its variants).
                   *
                   * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.
                   */
                  function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
                      // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
                      // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false
                      // and not revert is the subcall reverts.
              
                      (bool success, bytes memory returndata) = address(token).call(data);
                      return success && (returndata.length == 0 || abi.decode(returndata, (bool))) && address(token).code.length > 0;
                  }
              }
              
              
              
              
              
              
              
              
              
              
              
              contract AdminAuth is AuthHelper {
                  using SafeERC20 for IERC20;
              
                  AdminVault public constant adminVault = AdminVault(ADMIN_VAULT_ADDR);
              
                  error SenderNotOwner();
                  error SenderNotAdmin();
              
                  modifier onlyOwner() {
                      if (adminVault.owner() != msg.sender){
                          revert SenderNotOwner();
                      }
                      _;
                  }
              
                  modifier onlyAdmin() {
                      if (adminVault.admin() != msg.sender){
                          revert SenderNotAdmin();
                      }
                      _;
                  }
              
                  /// @notice withdraw stuck funds
                  function withdrawStuckFunds(address _token, address _receiver, uint256 _amount) public onlyOwner {
                      if (_token == 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE) {
                          payable(_receiver).transfer(_amount);
                      } else {
                          IERC20(_token).safeTransfer(_receiver, _amount);
                      }
                  }
              
                  /// @notice Destroy the contract
                  /// @dev Deprecated method, selfdestruct will soon just send eth
                  function kill() public onlyAdmin {
                      selfdestruct(payable(msg.sender));
                  }
              }
              
              
              
              
              
              
              
              
              contract DFSRegistry is AdminAuth {
                  error EntryAlreadyExistsError(bytes4);
                  error EntryNonExistentError(bytes4);
                  error EntryNotInChangeError(bytes4);
                  error ChangeNotReadyError(uint256,uint256);
                  error EmptyPrevAddrError(bytes4);
                  error AlreadyInContractChangeError(bytes4);
                  error AlreadyInWaitPeriodChangeError(bytes4);
              
                  event AddNewContract(address,bytes4,address,uint256);
                  event RevertToPreviousAddress(address,bytes4,address,address);
                  event StartContractChange(address,bytes4,address,address);
                  event ApproveContractChange(address,bytes4,address,address);
                  event CancelContractChange(address,bytes4,address,address);
                  event StartWaitPeriodChange(address,bytes4,uint256);
                  event ApproveWaitPeriodChange(address,bytes4,uint256,uint256);
                  event CancelWaitPeriodChange(address,bytes4,uint256,uint256);
              
                  struct Entry {
                      address contractAddr;
                      uint256 waitPeriod;
                      uint256 changeStartTime;
                      bool inContractChange;
                      bool inWaitPeriodChange;
                      bool exists;
                  }
              
                  mapping(bytes4 => Entry) public entries;
                  mapping(bytes4 => address) public previousAddresses;
              
                  mapping(bytes4 => address) public pendingAddresses;
                  mapping(bytes4 => uint256) public pendingWaitTimes;
              
                  /// @notice Given an contract id returns the registered address
                  /// @dev Id is keccak256 of the contract name
                  /// @param _id Id of contract
                  function getAddr(bytes4 _id) public view returns (address) {
                      return entries[_id].contractAddr;
                  }
              
                  /// @notice Helper function to easily query if id is registered
                  /// @param _id Id of contract
                  function isRegistered(bytes4 _id) public view returns (bool) {
                      return entries[_id].exists;
                  }
              
                  /////////////////////////// OWNER ONLY FUNCTIONS ///////////////////////////
              
                  /// @notice Adds a new contract to the registry
                  /// @param _id Id of contract
                  /// @param _contractAddr Address of the contract
                  /// @param _waitPeriod Amount of time to wait before a contract address can be changed
                  function addNewContract(
                      bytes4 _id,
                      address _contractAddr,
                      uint256 _waitPeriod
                  ) public onlyOwner {
                      if (entries[_id].exists){
                          revert EntryAlreadyExistsError(_id);
                      }
              
                      entries[_id] = Entry({
                          contractAddr: _contractAddr,
                          waitPeriod: _waitPeriod,
                          changeStartTime: 0,
                          inContractChange: false,
                          inWaitPeriodChange: false,
                          exists: true
                      });
              
                      emit AddNewContract(msg.sender, _id, _contractAddr, _waitPeriod);
                  }
              
                  /// @notice Reverts to the previous address immediately
                  /// @dev In case the new version has a fault, a quick way to fallback to the old contract
                  /// @param _id Id of contract
                  function revertToPreviousAddress(bytes4 _id) public onlyOwner {
                      if (!(entries[_id].exists)){
                          revert EntryNonExistentError(_id);
                      }
                      if (previousAddresses[_id] == address(0)){
                          revert EmptyPrevAddrError(_id);
                      }
              
                      address currentAddr = entries[_id].contractAddr;
                      entries[_id].contractAddr = previousAddresses[_id];
              
                      emit RevertToPreviousAddress(msg.sender, _id, currentAddr, previousAddresses[_id]);
                  }
              
                  /// @notice Starts an address change for an existing entry
                  /// @dev Can override a change that is currently in progress
                  /// @param _id Id of contract
                  /// @param _newContractAddr Address of the new contract
                  function startContractChange(bytes4 _id, address _newContractAddr) public onlyOwner {
                      if (!entries[_id].exists){
                          revert EntryNonExistentError(_id);
                      }
                      if (entries[_id].inWaitPeriodChange){
                          revert AlreadyInWaitPeriodChangeError(_id);
                      }
              
                      entries[_id].changeStartTime = block.timestamp; // solhint-disable-line
                      entries[_id].inContractChange = true;
              
                      pendingAddresses[_id] = _newContractAddr;
              
                      emit StartContractChange(msg.sender, _id, entries[_id].contractAddr, _newContractAddr);
                  }
              
                  /// @notice Changes new contract address, correct time must have passed
                  /// @param _id Id of contract
                  function approveContractChange(bytes4 _id) public onlyOwner {
                      if (!entries[_id].exists){
                          revert EntryNonExistentError(_id);
                      }
                      if (!entries[_id].inContractChange){
                          revert EntryNotInChangeError(_id);
                      }
                      if (block.timestamp < (entries[_id].changeStartTime + entries[_id].waitPeriod)){// solhint-disable-line
                          revert ChangeNotReadyError(block.timestamp, (entries[_id].changeStartTime + entries[_id].waitPeriod));
                      }
              
                      address oldContractAddr = entries[_id].contractAddr;
                      entries[_id].contractAddr = pendingAddresses[_id];
                      entries[_id].inContractChange = false;
                      entries[_id].changeStartTime = 0;
              
                      pendingAddresses[_id] = address(0);
                      previousAddresses[_id] = oldContractAddr;
              
                      emit ApproveContractChange(msg.sender, _id, oldContractAddr, entries[_id].contractAddr);
                  }
              
                  /// @notice Cancel pending change
                  /// @param _id Id of contract
                  function cancelContractChange(bytes4 _id) public onlyOwner {
                      if (!entries[_id].exists){
                          revert EntryNonExistentError(_id);
                      }
                      if (!entries[_id].inContractChange){
                          revert EntryNotInChangeError(_id);
                      }
              
                      address oldContractAddr = pendingAddresses[_id];
              
                      pendingAddresses[_id] = address(0);
                      entries[_id].inContractChange = false;
                      entries[_id].changeStartTime = 0;
              
                      emit CancelContractChange(msg.sender, _id, oldContractAddr, entries[_id].contractAddr);
                  }
              
                  /// @notice Starts the change for waitPeriod
                  /// @param _id Id of contract
                  /// @param _newWaitPeriod New wait time
                  function startWaitPeriodChange(bytes4 _id, uint256 _newWaitPeriod) public onlyOwner {
                      if (!entries[_id].exists){
                          revert EntryNonExistentError(_id);
                      }
                      if (entries[_id].inContractChange){
                          revert AlreadyInContractChangeError(_id);
                      }
              
                      pendingWaitTimes[_id] = _newWaitPeriod;
              
                      entries[_id].changeStartTime = block.timestamp; // solhint-disable-line
                      entries[_id].inWaitPeriodChange = true;
              
                      emit StartWaitPeriodChange(msg.sender, _id, _newWaitPeriod);
                  }
              
                  /// @notice Changes new wait period, correct time must have passed
                  /// @param _id Id of contract
                  function approveWaitPeriodChange(bytes4 _id) public onlyOwner {
                      if (!entries[_id].exists){
                          revert EntryNonExistentError(_id);
                      }
                      if (!entries[_id].inWaitPeriodChange){
                          revert EntryNotInChangeError(_id);
                      }
                      if (block.timestamp < (entries[_id].changeStartTime + entries[_id].waitPeriod)){ // solhint-disable-line
                          revert ChangeNotReadyError(block.timestamp, (entries[_id].changeStartTime + entries[_id].waitPeriod));
                      }
              
                      uint256 oldWaitTime = entries[_id].waitPeriod;
                      entries[_id].waitPeriod = pendingWaitTimes[_id];
                      
                      entries[_id].inWaitPeriodChange = false;
                      entries[_id].changeStartTime = 0;
              
                      pendingWaitTimes[_id] = 0;
              
                      emit ApproveWaitPeriodChange(msg.sender, _id, oldWaitTime, entries[_id].waitPeriod);
                  }
              
                  /// @notice Cancel wait period change
                  /// @param _id Id of contract
                  function cancelWaitPeriodChange(bytes4 _id) public onlyOwner {
                      if (!entries[_id].exists){
                          revert EntryNonExistentError(_id);
                      }
                      if (!entries[_id].inWaitPeriodChange){
                          revert EntryNotInChangeError(_id);
                      }
              
                      uint256 oldWaitPeriod = pendingWaitTimes[_id];
              
                      pendingWaitTimes[_id] = 0;
                      entries[_id].inWaitPeriodChange = false;
                      entries[_id].changeStartTime = 0;
              
                      emit CancelWaitPeriodChange(msg.sender, _id, oldWaitPeriod, entries[_id].waitPeriod);
                  }
              }
              
              
              
              
              
              
              
              abstract contract DSAuthority {
                  function canCall(
                      address src,
                      address dst,
                      bytes4 sig
                  ) public view virtual returns (bool);
              }
              
              
              
              
              
              
              
              contract DSAuthEvents {
                  event LogSetAuthority(address indexed authority);
                  event LogSetOwner(address indexed owner);
              }
              
              contract DSAuth is DSAuthEvents {
                  DSAuthority public authority;
                  address public owner;
              
                  constructor() {
                      owner = msg.sender;
                      emit LogSetOwner(msg.sender);
                  }
              
                  function setOwner(address owner_) public auth {
                      owner = owner_;
                      emit LogSetOwner(owner);
                  }
              
                  function setAuthority(DSAuthority authority_) public auth {
                      authority = authority_;
                      emit LogSetAuthority(address(authority));
                  }
              
                  modifier auth {
                      require(isAuthorized(msg.sender, msg.sig), "Not authorized");
                      _;
                  }
              
                  function isAuthorized(address src, bytes4 sig) internal view returns (bool) {
                      if (src == address(this)) {
                          return true;
                      } else if (src == owner) {
                          return true;
                      } else if (authority == DSAuthority(address(0))) {
                          return false;
                      } else {
                          return authority.canCall(src, address(this), sig);
                      }
                  }
              }
              
              
              
              
              
              
              
              contract DSNote {
                  event LogNote(
                      bytes4 indexed sig,
                      address indexed guy,
                      bytes32 indexed foo,
                      bytes32 indexed bar,
                      uint256 wad,
                      bytes fax
                  ) anonymous;
              
                  modifier note {
                      bytes32 foo;
                      bytes32 bar;
              
                      assembly {
                          foo := calldataload(4)
                          bar := calldataload(36)
                      }
              
                      emit LogNote(msg.sig, msg.sender, foo, bar, msg.value, msg.data);
              
                      _;
                  }
              }
              
              
              
              
              
              
              
              
              abstract contract DSProxy is DSAuth, DSNote {
                  DSProxyCache public cache; // global cache for contracts
              
                  constructor(address _cacheAddr) {
                      if (!(setCache(_cacheAddr))){
                          require(isAuthorized(msg.sender, msg.sig), "Not authorized");
                      }
                  }
              
                  // solhint-disable-next-line no-empty-blocks
                  receive() external payable {}
              
                  // use the proxy to execute calldata _data on contract _code
                  function execute(bytes memory _code, bytes memory _data)
                      public
                      payable
                      virtual
                      returns (address target, bytes32 response);
              
                  function execute(address _target, bytes memory _data)
                      public
                      payable
                      virtual
                      returns (bytes32 response);
              
                  //set new cache
                  function setCache(address _cacheAddr) public payable virtual returns (bool);
              }
              
              contract DSProxyCache {
                  mapping(bytes32 => address) cache;
              
                  function read(bytes memory _code) public view returns (address) {
                      bytes32 hash = keccak256(_code);
                      return cache[hash];
                  }
              
                  function write(bytes memory _code) public returns (address target) {
                      assembly {
                          target := create(0, add(_code, 0x20), mload(_code))
                          switch iszero(extcodesize(target))
                              case 1 {
                                  // throw if contract failed to deploy
                                  revert(0, 0)
                              }
                      }
                      bytes32 hash = keccak256(_code);
                      cache[hash] = target;
                  }
              }
              
              
              
              
              
              
              
              interface ISafe {
                  enum Operation {
                      Call,
                      DelegateCall
                  }
              
                  function setup(
                      address[] calldata _owners,
                      uint256 _threshold,
                      address to,
                      bytes calldata data,
                      address fallbackHandler,
                      address paymentToken,
                      uint256 payment,
                      address payable paymentReceiver
                  ) external;
              
                  function execTransaction(
                      address to,
                      uint256 value,
                      bytes calldata data,
                      Operation operation,
                      uint256 safeTxGas,
                      uint256 baseGas,
                      uint256 gasPrice,
                      address gasToken,
                      address payable refundReceiver,
                      bytes memory signatures
                  ) external payable returns (bool success);
              
                  function execTransactionFromModule(
                      address to,
                      uint256 value,
                      bytes memory data,
                      Operation operation
                  ) external returns (bool success);
              
                  function checkSignatures(
                      bytes32 dataHash,
                      bytes memory data,
                      bytes memory signatures
                  ) external view;
              
                  function checkNSignatures(
                      address executor,
                      bytes32 dataHash,
                      bytes memory /* data */,
                      bytes memory signatures,
                      uint256 requiredSignatures
                  ) external view;
              
                  function approveHash(bytes32 hashToApprove) external;
              
                  function domainSeparator() external view returns (bytes32);
              
                  function getTransactionHash(
                      address to,
                      uint256 value,
                      bytes calldata data,
                      Operation operation,
                      uint256 safeTxGas,
                      uint256 baseGas,
                      uint256 gasPrice,
                      address gasToken,
                      address refundReceiver,
                      uint256 _nonce
                  ) external view returns (bytes32);
              
                  function nonce() external view returns (uint256);
              
                  function setFallbackHandler(address handler) external;
              
                  function getOwners() external view returns (address[] memory);
              
                  function isOwner(address owner) external view returns (bool);
              
                  function getThreshold() external view returns (uint256);
              
                  function enableModule(address module) external;
              
                  function isModuleEnabled(address module) external view returns (bool);
              
                  function disableModule(address prevModule, address module) external;
              
                  function getModulesPaginated(
                      address start,
                      uint256 pageSize
                  ) external view returns (address[] memory array, address next);
              }
              
              
              
              
              
              
              
              interface IDSProxyFactory {
                  function isProxy(address _proxy) external view returns (bool);
              }
              
              
              
              
              
              
              
              contract MainnetProxyFactoryAddresses {
                  address internal constant PROXY_FACTORY_ADDR = 0xA26e15C895EFc0616177B7c1e7270A4C7D51C997;
              }
              
              
              
              
              
              
              
              contract DSProxyFactoryHelper is MainnetProxyFactoryAddresses {
              }
              
              
              
              
              
              
              
              
              
              contract CheckWalletType is DSProxyFactoryHelper {
                  function isDSProxy(address _proxy) public view returns (bool) {
                      return IDSProxyFactory(PROXY_FACTORY_ADDR).isProxy(_proxy);
                  }
              }
              
              
              
              
              
              
              
              contract DefisaverLogger {
                  event RecipeEvent(
                      address indexed caller,
                      string indexed logName
                  );
              
                  event ActionDirectEvent(
                      address indexed caller,
                      string indexed logName,
                      bytes data
                  );
              
                  function logRecipeEvent(
                      string memory _logName
                  ) public {
                      emit RecipeEvent(msg.sender, _logName);
                  }
              
                  function logActionDirectEvent(
                      string memory _logName,
                      bytes memory _data
                  ) public {
                      emit ActionDirectEvent(msg.sender, _logName, _data);
                  }
              }
              
              
              
              
              
              
              
              
              
              
              
              
              
              abstract contract ActionBase is AdminAuth, ActionsUtilHelper, CheckWalletType {
                  event ActionEvent(
                      string indexed logName,
                      bytes data
                  );
              
                  DFSRegistry public constant registry = DFSRegistry(REGISTRY_ADDR);
              
                  DefisaverLogger public constant logger = DefisaverLogger(
                      DFS_LOGGER_ADDR
                  );
              
                  //Wrong sub index value
                  error SubIndexValueError();
                  //Wrong return index value
                  error ReturnIndexValueError();
              
                  /// @dev Subscription params index range [128, 255]
                  uint8 public constant SUB_MIN_INDEX_VALUE = 128;
                  uint8 public constant SUB_MAX_INDEX_VALUE = 255;
              
                  /// @dev Return params index range [1, 127]
                  uint8 public constant RETURN_MIN_INDEX_VALUE = 1;
                  uint8 public constant RETURN_MAX_INDEX_VALUE = 127;
              
                  /// @dev If the input value should not be replaced
                  uint8 public constant NO_PARAM_MAPPING = 0;
              
                  /// @dev We need to parse Flash loan actions in a different way
                  enum ActionType { FL_ACTION, STANDARD_ACTION, FEE_ACTION, CHECK_ACTION, CUSTOM_ACTION }
              
                  /// @notice Parses inputs and runs the implemented action through a user wallet
                  /// @dev Is called by the RecipeExecutor chaining actions together
                  /// @param _callData Array of input values each value encoded as bytes
                  /// @param _subData Array of subscribed vales, replaces input values if specified
                  /// @param _paramMapping Array that specifies how return and subscribed values are mapped in input
                  /// @param _returnValues Returns values from actions before, which can be injected in inputs
                  /// @return Returns a bytes32 value through user wallet, each actions implements what that value is
                  function executeAction(
                      bytes memory _callData,
                      bytes32[] memory _subData,
                      uint8[] memory _paramMapping,
                      bytes32[] memory _returnValues
                  ) public payable virtual returns (bytes32);
              
                  /// @notice Parses inputs and runs the single implemented action through a user wallet
                  /// @dev Used to save gas when executing a single action directly
                  function executeActionDirect(bytes memory _callData) public virtual payable;
              
                  /// @notice Returns the type of action we are implementing
                  function actionType() public pure virtual returns (uint8);
              
              
                  //////////////////////////// HELPER METHODS ////////////////////////////
              
                  /// @notice Given an uint256 input, injects return/sub values if specified
                  /// @param _param The original input value
                  /// @param _mapType Indicated the type of the input in paramMapping
                  /// @param _subData Array of subscription data we can replace the input value with
                  /// @param _returnValues Array of subscription data we can replace the input value with
                  function _parseParamUint(
                      uint _param,
                      uint8 _mapType,
                      bytes32[] memory _subData,
                      bytes32[] memory _returnValues
                  ) internal pure returns (uint) {
                      if (isReplaceable(_mapType)) {
                          if (isReturnInjection(_mapType)) {
                              _param = uint(_returnValues[getReturnIndex(_mapType)]);
                          } else {
                              _param = uint256(_subData[getSubIndex(_mapType)]);
                          }
                      }
              
                      return _param;
                  }
              
              
                  /// @notice Given an addr input, injects return/sub values if specified
                  /// @param _param The original input value
                  /// @param _mapType Indicated the type of the input in paramMapping
                  /// @param _subData Array of subscription data we can replace the input value with
                  /// @param _returnValues Array of subscription data we can replace the input value with
                  function _parseParamAddr(
                      address _param,
                      uint8 _mapType,
                      bytes32[] memory _subData,
                      bytes32[] memory _returnValues
                  ) internal view returns (address) {
                      if (isReplaceable(_mapType)) {
                          if (isReturnInjection(_mapType)) {
                              _param = address(bytes20((_returnValues[getReturnIndex(_mapType)])));
                          } else {
                              /// @dev The last two values are specially reserved for proxy addr and owner addr
                              if (_mapType == 254) return address(this); // wallet address
                              if (_mapType == 255) return fetchOwnersOrWallet(); // owner if 1/1 wallet or the wallet itself
              
                              _param = address(uint160(uint256(_subData[getSubIndex(_mapType)])));
                          }
                      }
              
                      return _param;
                  }
              
                  /// @notice Given an bytes32 input, injects return/sub values if specified
                  /// @param _param The original input value
                  /// @param _mapType Indicated the type of the input in paramMapping
                  /// @param _subData Array of subscription data we can replace the input value with
                  /// @param _returnValues Array of subscription data we can replace the input value with
                  function _parseParamABytes32(
                      bytes32 _param,
                      uint8 _mapType,
                      bytes32[] memory _subData,
                      bytes32[] memory _returnValues
                  ) internal pure returns (bytes32) {
                      if (isReplaceable(_mapType)) {
                          if (isReturnInjection(_mapType)) {
                              _param = (_returnValues[getReturnIndex(_mapType)]);
                          } else {
                              _param = _subData[getSubIndex(_mapType)];
                          }
                      }
              
                      return _param;
                  }
              
                  /// @notice Checks if the paramMapping value indicated that we need to inject values
                  /// @param _type Indicated the type of the input
                  function isReplaceable(uint8 _type) internal pure returns (bool) {
                      return _type != NO_PARAM_MAPPING;
                  }
              
                  /// @notice Checks if the paramMapping value is in the return value range
                  /// @param _type Indicated the type of the input
                  function isReturnInjection(uint8 _type) internal pure returns (bool) {
                      return (_type >= RETURN_MIN_INDEX_VALUE) && (_type <= RETURN_MAX_INDEX_VALUE);
                  }
              
                  /// @notice Transforms the paramMapping value to the index in return array value
                  /// @param _type Indicated the type of the input
                  function getReturnIndex(uint8 _type) internal pure returns (uint8) {
                      if (!(isReturnInjection(_type))){
                          revert SubIndexValueError();
                      }
              
                      return (_type - RETURN_MIN_INDEX_VALUE);
                  }
              
                  /// @notice Transforms the paramMapping value to the index in sub array value
                  /// @param _type Indicated the type of the input
                  function getSubIndex(uint8 _type) internal pure returns (uint8) {
                      if (_type < SUB_MIN_INDEX_VALUE){
                          revert ReturnIndexValueError();
                      }
                      return (_type - SUB_MIN_INDEX_VALUE);
                  }
              
                  function fetchOwnersOrWallet() internal view returns (address) {
                      if (isDSProxy(address(this))) 
                          return DSProxy(payable(address(this))).owner();
              
                      // if not DSProxy, we assume we are in context of Safe
                      address[] memory owners = ISafe(address(this)).getOwners();
                      return owners.length == 1 ? owners[0] : address(this);
                  }
              }
              
              
              
              
              
              
              
              contract MainnetMcdAddresses {
                  address internal constant POT_ADDR = 0x197E90f9FAD81970bA7976f33CbD77088E5D7cf7;
                  address internal constant VAT_ADDR = 0x35D1b3F3D7966A1DFe207aa4514C12a259A0492B;
                  address internal constant DAI_JOIN_ADDR = 0x9759A6Ac90977b93B58547b4A71c78317f391A28;
                  address internal constant JUG_ADDRESS = 0x19c0976f590D67707E62397C87829d896Dc0f1F1;
                  address internal constant SPOTTER_ADDRESS = 0x65C79fcB50Ca1594B025960e539eD7A9a6D434A3;
                  address internal constant PROXY_REGISTRY_ADDR = 0x4678f0a6958e4D2Bc4F1BAF7Bc52E8F3564f3fE4;
              
                  address internal constant CDP_REGISTRY = 0xBe0274664Ca7A68d6b5dF826FB3CcB7c620bADF3;
                  address internal constant CROPPER = 0x8377CD01a5834a6EaD3b7efb482f678f2092b77e;
                  address internal constant MCD_MANAGER_ADDR = 0x5ef30b9986345249bc32d8928B7ee64DE9435E39;
                  address internal constant DAI_ADDRESS = 0x6B175474E89094C44Da98b954EedeAC495271d0F;
                  address internal constant MKR_ADDRESS = 0x9f8F72aA9304c8B593d555F12eF6589cC3A579A2;
                  address internal constant SKY_ADDRESS = 0x56072C95FAA701256059aa122697B133aDEd9279;
                  address internal constant USDS_ADDRESS = 0xdC035D45d973E3EC169d2276DDab16f1e407384F;
                  
                  address internal constant MRK_SKY_CONVERTER = 0xBDcFCA946b6CDd965f99a839e4435Bcdc1bc470B;
                  address internal constant DAI_USDS_CONVERTER = 0x3225737a9Bbb6473CB4a45b7244ACa2BeFdB276A;
              }
              
              
              
              
              
              
              contract DSMath {
                  function add(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = x + y;
                  }
              
                  function sub(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = x - y;
                  }
              
                  function mul(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = x * y;
                  }
              
                  function div(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      return x / y;
                  }
              
                  function min(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      return x <= y ? x : y;
                  }
              
                  function max(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      return x >= y ? x : y;
                  }
              
                  function imin(int256 x, int256 y) internal pure returns (int256 z) {
                      return x <= y ? x : y;
                  }
              
                  function imax(int256 x, int256 y) internal pure returns (int256 z) {
                      return x >= y ? x : y;
                  }
              
                  uint256 constant WAD = 10**18;
                  uint256 constant RAY = 10**27;
              
                  function wmul(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = add(mul(x, y), WAD / 2) / WAD;
                  }
              
                  function rmul(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = add(mul(x, y), RAY / 2) / RAY;
                  }
              
                  function wdiv(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = add(mul(x, WAD), y / 2) / y;
                  }
              
                  function rdiv(uint256 x, uint256 y) internal pure returns (uint256 z) {
                      z = add(mul(x, RAY), y / 2) / y;
                  }
              
                  // This famous algorithm is called "exponentiation by squaring"
                  // and calculates x^n with x as fixed-point and n as regular unsigned.
                  //
                  // It's O(log n), instead of O(n) for naive repeated multiplication.
                  //
                  // These facts are why it works:
                  //
                  //  If n is even, then x^n = (x^2)^(n/2).
                  //  If n is odd,  then x^n = x * x^(n-1),
                  //   and applying the equation for even x gives
                  //    x^n = x * (x^2)^((n-1) / 2).
                  //
                  //  Also, EVM division is flooring and
                  //    floor[(n-1) / 2] = floor[n / 2].
                  //
                  function rpow(uint256 x, uint256 n) internal pure returns (uint256 z) {
                      z = n % 2 != 0 ? x : RAY;
              
                      for (n /= 2; n != 0; n /= 2) {
                          x = rmul(x, x);
              
                          if (n % 2 != 0) {
                              z = rmul(z, x);
                          }
                      }
                  }
              }
              
              
              
              
              
              
              
              abstract contract IGem {
                  function dec() virtual public returns (uint);
                  function gem() virtual public returns (IGem);
                  function join(address, uint) virtual public payable;
                  function exit(address, uint) virtual public;
              
                  function approve(address, uint) virtual public;
                  function transfer(address, uint) virtual public returns (bool);
                  function transferFrom(address, address, uint) virtual public returns (bool);
                  function deposit() virtual public payable;
                  function withdraw(uint) virtual public;
                  function allowance(address, address) virtual public returns (uint);
              }
              
              
              
              
              
              
              
              abstract contract IVat {
              
                  struct Urn {
                      uint256 ink;   // Locked Collateral  [wad]
                      uint256 art;   // Normalised Debt    [wad]
                  }
              
                  struct Ilk {
                      uint256 Art;   // Total Normalised Debt     [wad]
                      uint256 rate;  // Accumulated Rates         [ray]
                      uint256 spot;  // Price with Safety Margin  [ray]
                      uint256 line;  // Debt Ceiling              [rad]
                      uint256 dust;  // Urn Debt Floor            [rad]
                  }
              
                  mapping (bytes32 => mapping (address => Urn )) public urns;
                  mapping (bytes32 => Ilk)                       public ilks;
                  mapping (bytes32 => mapping (address => uint)) public gem;  // [wad]
              
                  function can(address, address) virtual public view returns (uint);
                  function dai(address) virtual public view returns (uint);
                  function frob(bytes32, address, address, address, int, int) virtual public;
                  function hope(address) virtual public;
                  function nope(address) virtual public;
                  function move(address, address, uint) virtual public;
                  function fork(bytes32, address, address, int, int) virtual public;
              }
              
              
              
              
              
              
              
              
              abstract contract ICdpRegistry {
                  function open(
                      bytes32 ilk,
                      address usr
                  ) public virtual returns (uint256);
              
                  function cdps(bytes32, address) virtual public view returns (uint256);
                  function owns(uint) virtual public view returns (address);
                  function ilks(uint) virtual public view returns (bytes32);
              
              }
              
              
              
              
              
              
              
              interface ICropper {
                  function proxy(address) view external returns (address);
                  function getOrCreateProxy(address) external returns (address);
                  function join(address, address, uint256) external;
                  function exit(address, address, uint256) external;
                  function flee(address, address, uint256) external;
                  function frob(bytes32, address, address, address, int256, int256) external;
                  function quit(bytes32, address, address) external;
              }
              
              
              
              
              
              
              
              abstract contract IJoin {
                  bytes32 public ilk;
              
                  function dec() virtual public view returns (uint);
                  function gem() virtual public view returns (IGem);
                  function join(address, uint) virtual public payable;
                  function exit(address, uint) virtual public;
              }
              
              
              
              
              
              
              
              abstract contract IManager {
                  function last(address) virtual public returns (uint);
                  function cdpCan(address, uint, address) virtual public view returns (uint);
                  function ilks(uint) virtual public view returns (bytes32);
                  function owns(uint) virtual public view returns (address);
                  function urns(uint) virtual public view returns (address);
                  function vat() virtual public view returns (address);
                  function open(bytes32, address) virtual public returns (uint);
                  function give(uint, address) virtual public;
                  function cdpAllow(uint, address, uint) virtual public;
                  function urnAllow(address, uint) virtual public;
                  function frob(uint, int, int) virtual public;
                  function flux(uint, address, uint) virtual public;
                  function move(uint, address, uint) virtual public;
                  function exit(address, uint, address, uint) virtual public;
                  function quit(uint, address) virtual public;
                  function enter(address, uint) virtual public;
                  function shift(uint, uint) virtual public;
              }
              
              
              
              
              
              
              
              abstract contract IWETH {
                  function allowance(address, address) public virtual view returns (uint256);
              
                  function balanceOf(address) public virtual view returns (uint256);
              
                  function approve(address, uint256) public virtual;
              
                  function transfer(address, uint256) public virtual returns (bool);
              
                  function transferFrom(
                      address,
                      address,
                      uint256
                  ) public virtual returns (bool);
              
                  function deposit() public payable virtual;
              
                  function withdraw(uint256) public virtual;
              }
              
              
              
              
              
              
              
              
              
              library TokenUtils {
                  using SafeERC20 for IERC20;
              
                  address public constant WETH_ADDR = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
                  address public constant ETH_ADDR = 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE;
              
                  /// @dev Only approves the amount if allowance is lower than amount, does not decrease allowance
                  function approveToken(
                      address _tokenAddr,
                      address _to,
                      uint256 _amount
                  ) internal {
                      if (_tokenAddr == ETH_ADDR) return;
              
                      if (IERC20(_tokenAddr).allowance(address(this), _to) < _amount) {
                          IERC20(_tokenAddr).safeApprove(_to, _amount);
                      }
                  }
              
                  function pullTokensIfNeeded(
                      address _token,
                      address _from,
                      uint256 _amount
                  ) internal returns (uint256) {
                      // handle max uint amount
                      if (_amount == type(uint256).max) {
                          _amount = getBalance(_token, _from);
                      }
              
                      if (_from != address(0) && _from != address(this) && _token != ETH_ADDR && _amount != 0) {
                          IERC20(_token).safeTransferFrom(_from, address(this), _amount);
                      }
              
                      return _amount;
                  }
              
                  function withdrawTokens(
                      address _token,
                      address _to,
                      uint256 _amount
                  ) internal returns (uint256) {
                      if (_amount == type(uint256).max) {
                          _amount = getBalance(_token, address(this));
                      }
              
                      if (_to != address(0) && _to != address(this) && _amount != 0) {
                          if (_token != ETH_ADDR) {
                              IERC20(_token).safeTransfer(_to, _amount);
                          } else {
                              (bool success, ) = _to.call{value: _amount}("");
                              require(success, "Eth send fail");
                          }
                      }
              
                      return _amount;
                  }
              
                  function depositWeth(uint256 _amount) internal {
                      IWETH(WETH_ADDR).deposit{value: _amount}();
                  }
              
                  function withdrawWeth(uint256 _amount) internal {
                      IWETH(WETH_ADDR).withdraw(_amount);
                  }
              
                  function getBalance(address _tokenAddr, address _acc) internal view returns (uint256) {
                      if (_tokenAddr == ETH_ADDR) {
                          return _acc.balance;
                      } else {
                          return IERC20(_tokenAddr).balanceOf(_acc);
                      }
                  }
              
                  function getTokenDecimals(address _token) internal view returns (uint256) {
                      if (_token == ETH_ADDR) return 18;
              
                      return IERC20(_token).decimals();
                  }
              }
              
              
              
              
              
              
              
              
              
              
              
              
              
              
              
              
              contract McdHelper is DSMath, MainnetMcdAddresses {
              
                  IVat public constant vat = IVat(VAT_ADDR);
              
                  error IntOverflow();
              
                  /// @notice Returns a normalized debt _amount based on the current rate
                  /// @param _amount Amount of dai to be normalized
                  /// @param _rate Current rate of the stability fee
                  /// @param _daiVatBalance Balance od Dai in the Vat for that CDP
                  function normalizeDrawAmount(uint _amount, uint _rate, uint _daiVatBalance) internal pure returns (int dart) {
                      if (_daiVatBalance < _amount * RAY) {
                          dart = toPositiveInt((_amount * RAY - _daiVatBalance) / _rate);
                          dart = uint(dart) * _rate < _amount * RAY ? dart + 1 : dart;
                      }
                  }
              
                  /// @notice Converts a number to Rad precision
                  /// @param _wad The input number in wad precision
                  function toRad(uint _wad) internal pure returns (uint) {
                      return _wad * (10 ** 27);
                  }
              
                  /// @notice Converts a number to 18 decimal precision
                  /// @dev If token decimal is bigger than 18, function reverts
                  /// @param _joinAddr Join address of the collateral
                  /// @param _amount Number to be converted
                  function convertTo18(address _joinAddr, uint256 _amount) internal view returns (uint256) {
                      return _amount * (10 ** (18 - IJoin(_joinAddr).dec()));
                  }
              
                  /// @notice Converts a uint to int and checks if positive
                  /// @param _x Number to be converted
                  function toPositiveInt(uint _x) internal pure returns (int y) {
                      y = int(_x);
                      if (y < 0){
                          revert IntOverflow();
                      }
                  }
              
                  /// @notice Gets Dai amount in Vat which can be added to Cdp
                  /// @param _vat Address of Vat contract
                  /// @param _daiBalance Amount of dai in vat contract for that urn
                  /// @param _urn Urn of the Cdp
                  /// @param _ilk Ilk of the Cdp
                  function normalizePaybackAmount(address _vat, uint256 _daiBalance, address _urn, bytes32 _ilk) internal view returns (int amount) {
              
                      (, uint rate,,,) = IVat(_vat).ilks(_ilk);
                      (, uint art) = IVat(_vat).urns(_ilk, _urn);
              
                      amount = toPositiveInt(_daiBalance / rate);
                      amount = uint(amount) <= art ? - amount : - toPositiveInt(art);
                  }
              
                  /// @notice Gets the whole debt of the CDP
                  /// @param _vat Address of Vat contract
                  /// @param _usr Address of the Dai holder
                  /// @param _urn Urn of the Cdp
                  /// @param _ilk Ilk of the Cdp
                  function getAllDebt(address _vat, address _usr, address _urn, bytes32 _ilk) internal view returns (uint daiAmount) {
                      (, uint rate,,,) = IVat(_vat).ilks(_ilk);
                      (, uint art) = IVat(_vat).urns(_ilk, _urn);
                      uint dai = IVat(_vat).dai(_usr);
              
                      uint rad = art * rate - dai;
                      daiAmount = rad / RAY;
              
                      // handles precision error (off by 1 wei)
                      daiAmount = daiAmount * RAY < rad ? daiAmount + 1 : daiAmount;
                  }
              
                  /// @notice Checks if the join address is one of the Ether coll. types
                  /// @param _joinAddr Join address to check
                  function isEthJoinAddr(address _joinAddr) internal view returns (bool) {
                      // if it's dai_join_addr don't check gem() it will fail
                      if (_joinAddr == DAI_JOIN_ADDR) return false;
              
                      // if coll is weth it's and eth type coll
                      if (address(IJoin(_joinAddr).gem()) == TokenUtils.WETH_ADDR) {
                          return true;
                      }
              
                      return false;
                  }
              
                  /// @notice Returns the underlying token address from the joinAddr
                  /// @dev For eth based collateral returns 0xEee... not weth addr
                  /// @param _joinAddr Join address to check
                  function getTokenFromJoin(address _joinAddr) internal view returns (address) {
                      // if it's dai_join_addr don't check gem() it will fail, return dai addr
                      if (_joinAddr == DAI_JOIN_ADDR) {
                          return DAI_ADDRESS;
                      }
              
                      return address(IJoin(_joinAddr).gem());
                  }
              
                  function getUrnAndIlk(address _mcdManager, uint256 _vaultId) public view returns (address urn, bytes32 ilk) {
                      if (_mcdManager == CROPPER) {
                          address owner = ICdpRegistry(CDP_REGISTRY).owns(_vaultId);
                          urn = ICropper(CROPPER).proxy(owner);
                          ilk = ICdpRegistry(CDP_REGISTRY).ilks(_vaultId);
                      } else {
                          urn = IManager(_mcdManager).urns(_vaultId);
                          ilk = IManager(_mcdManager).ilks(_vaultId);
                      }
                  }
              
                  /// @notice Gets CDP info (collateral, debt)
                  /// @param _manager Manager contract
                  /// @param _cdpId Id of the CDP
                  /// @param _ilk Ilk of the CDP
                  function getCdpInfo(IManager _manager, uint _cdpId, bytes32 _ilk) public view returns (uint, uint) {
                      address urn;
              
                      if (address(_manager) == CROPPER) {
                          address owner = ICdpRegistry(CDP_REGISTRY).owns(_cdpId);
                          urn = ICropper(CROPPER).proxy(owner);
                      } else {
                          urn = _manager.urns(_cdpId);
                      }
              
                      (uint collateral, uint debt) = vat.urns(_ilk, urn);
                      (,uint rate,,,) = vat.ilks(_ilk);
              
                      return (collateral, rmul(debt, rate));
                  }
              
                  /// @notice Returns all the collateral of the vault, formatted in the correct decimal
                  /// @dev Will fail if token is over 18 decimals
                  function getAllColl(IManager _mcdManager, address _joinAddr, uint _vaultId) internal view returns (uint amount) {
                      bytes32 ilk;
              
                      if (address(_mcdManager) == CROPPER) {
                          ilk = ICdpRegistry(CDP_REGISTRY).ilks(_vaultId);
                      } else {
                          ilk = _mcdManager.ilks(_vaultId);
                      }
              
                      (amount, ) = getCdpInfo(
                          _mcdManager,
                          _vaultId,
                          ilk
                      );
              
                      if (IJoin(_joinAddr).dec() != 18) {
                          return div(amount, 10 ** sub(18, IJoin(_joinAddr).dec()));
                      }
                  }
              }
              
              
              
              
              
              
              
              interface IDaiUSDSConverter {
                  function usdsToDai(address usr, uint256 wad) external;
                  function daiToUsds(address usr, uint256 wad) external;
              }
              
              
              
              
              
              
              
              interface IMkrSkyConverter {
                  function skyToMkr(address usr, uint256 skyAmt) external;
                  function mkrToSky(address usr, uint256 mkrAmt) external;
                  function rate() external returns (uint256);
              }
              
              
              
              
              
              
              
              
              
              
              
              
              contract McdTokenConverter is ActionBase, McdHelper {
                  using TokenUtils for address;
              
                  struct Params {
                      address tokenAddr;
                      address from;
                      address to;
                      uint256 amount;
                  }
              
                  /// @inheritdoc ActionBase
                  function executeAction(
                      bytes memory _callData,
                      bytes32[] memory _subData,
                      uint8[] memory _paramMapping,
                      bytes32[] memory _returnValues
                  ) public payable virtual override returns (bytes32) {
                      Params memory inputData = parseInputs(_callData);
              
                      inputData.tokenAddr = _parseParamAddr(inputData.tokenAddr, _paramMapping[0], _subData, _returnValues);
                      inputData.from = _parseParamAddr(inputData.from, _paramMapping[1], _subData, _returnValues);
                      inputData.to = _parseParamAddr(inputData.to, _paramMapping[2], _subData, _returnValues);
                      inputData.amount = _parseParamUint(inputData.amount, _paramMapping[3], _subData, _returnValues);
              
                      (uint256 newTokenAmount, bytes memory logData) = _mcdConvert(inputData);
                      emit ActionEvent("McdTokenConverter", logData);
                      return bytes32(newTokenAmount);
                  }
              
                  /// @inheritdoc ActionBase
                  function executeActionDirect(bytes memory _callData) public payable override {
                      Params memory inputData = parseInputs(_callData);
                      (, bytes memory logData) = _mcdConvert(inputData);
                      logger.logActionDirectEvent("McdTokenConverter", logData);
                  }
              
                  /// @inheritdoc ActionBase
                  function actionType() public pure virtual override returns (uint8) {
                      return uint8(ActionType.STANDARD_ACTION);
                  }
              
                  //////////////////////////// ACTION LOGIC ////////////////////////////
              
                  function _mcdConvert(Params memory _inputData) internal returns (uint256, bytes memory) {
                      _inputData.amount = _inputData.tokenAddr.pullTokensIfNeeded(_inputData.from, _inputData.amount);
                      uint256 newTokenAmount;
              
                      if (_inputData.tokenAddr == USDS_ADDRESS){
                          USDS_ADDRESS.approveToken(DAI_USDS_CONVERTER, _inputData.amount);
                          IDaiUSDSConverter(DAI_USDS_CONVERTER).usdsToDai(_inputData.to, _inputData.amount);
                          newTokenAmount = _inputData.amount;
              
                      } else if (_inputData.tokenAddr == DAI_ADDRESS) {    
                          DAI_ADDRESS.approveToken(DAI_USDS_CONVERTER, _inputData.amount);
                          IDaiUSDSConverter(DAI_USDS_CONVERTER).daiToUsds(_inputData.to, _inputData.amount);
                          newTokenAmount = _inputData.amount;
              
                      } else if (_inputData.tokenAddr == SKY_ADDRESS){
                          SKY_ADDRESS.approveToken(MRK_SKY_CONVERTER, _inputData.amount);
                          IMkrSkyConverter(MRK_SKY_CONVERTER).skyToMkr(_inputData.to, _inputData.amount);
                          newTokenAmount = _inputData.amount / IMkrSkyConverter(MRK_SKY_CONVERTER).rate();
              
                      } else if (_inputData.tokenAddr == MKR_ADDRESS){
                          MKR_ADDRESS.approveToken(MRK_SKY_CONVERTER, _inputData.amount);
                          IMkrSkyConverter(MRK_SKY_CONVERTER).mkrToSky(_inputData.to, _inputData.amount);
                          newTokenAmount = _inputData.amount * IMkrSkyConverter(MRK_SKY_CONVERTER).rate();
                      }
                      return (newTokenAmount, abi.encode(_inputData, newTokenAmount));
                  }
              
                  function parseInputs(bytes memory _callData) public pure returns (Params memory params) {
                      params = abi.decode(_callData, (Params));
                  }
              }
              

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