ETH Price: $3,200.07 (-0.06%)

Contract

0xA6d0f5bb034312f9a4fC565e916B84c264160994
 

Overview

ETH Balance

0 ETH

Eth Value

$0.00

Multichain Info

No addresses found
Transaction Hash
Method
Block
From
To
Adjust Min204712282024-08-06 18:09:5996 days ago1722967799IN
0xA6d0f5bb...264160994
0 ETH0.000143475
Adjust Cap204712212024-08-06 18:08:3596 days ago1722967715IN
0xA6d0f5bb...264160994
0 ETH0.000275046
Add To Whitelist204703022024-08-06 15:03:2396 days ago1722956603IN
0xA6d0f5bb...264160994
0 ETH0.0006142312
0x60c06040203379832024-07-19 3:47:47115 days ago1721360867IN
 Contract Creation
0 ETH0.016293885.26113901

View more zero value Internal Transactions in Advanced View mode

Advanced mode:
Loading...
Loading

Similar Match Source Code
This contract matches the deployed Bytecode of the Source Code for Contract 0x84f076Ff...e4C7C3f89
The constructor portion of the code might be different and could alter the actual behaviour of the contract

Contract Name:
OffchainFund

Compiler Version
v0.8.14+commit.80d49f37

Optimization Enabled:
Yes with 200 runs

Other Settings:
london EvmVersion
File 1 of 14 : OffchainFund.sol
// SPDX-License-Identifier: BSL 1.1

pragma solidity ^0.8.13;

import {Math} from "openzeppelin-contracts/contracts/utils/math/Math.sol";

import {Ownable} from "openzeppelin-contracts/contracts/access/Ownable.sol";
import {AccessControl} from "openzeppelin-contracts/contracts/access/AccessControl.sol";

import {ERC20} from "openzeppelin-contracts/contracts/token/ERC20/ERC20.sol";

import {IAccessControl} from "openzeppelin-contracts/contracts/access/IAccessControl.sol";

import {IERC20} from "openzeppelin-contracts/contracts/token/ERC20/IERC20.sol";
import {IERC20Metadata} from "openzeppelin-contracts/contracts/token/ERC20/extensions/IERC20Metadata.sol";

import {IOffchainFundUser} from "src/interfaces/IOffchainFundUser.sol";
import {IOffchainFundAdmin} from "src/interfaces/IOffchainFundAdmin.sol";

interface IOffchainFund is
    IOffchainFundUser,
    IOffchainFundAdmin,
    IAccessControl,
    IERC20,
    IERC20Metadata
{
    struct Order {
        uint256 epoch;
        uint256 amount;
    }

    /// @dev Net asset value of the fund
    /// @return nav Net asset value
    function nav() external view returns (uint256 nav);

    /// @dev Maximum `USDC` balance that can be held
    /// @return cap Maximum `USDC` balance that can be held
    function cap() external view returns (uint256 cap);

    /// @dev Minimum `USDC` balance that can be deposited
    /// @return min Minimum `USDC` balance that can be deposited
    function min() external view returns (uint256 min);

    /// @dev Current increment for the net asset value updates
    /// @return epoch Current increment for the net asset value updates
    function epoch() external view returns (uint256 epoch);

    /// @dev Price per share as calculated by the net asset value
    /// @return currentPrice Price per share
    function currentPrice() external view returns (uint256 currentPrice);

    /// @dev Total number of shares
    /// @return totalShares Total number of shares
    function totalShares() external view returns (uint256 totalShares);

    /// @dev State of a user's pending deposits
    /// @param account Address that placed the order
    /// @return epoch The epoch of the deposit
    /// @return amount The amount of `USDC` deposited
    function userDeposits(
        address account
    ) external view returns (uint256 epoch, uint256 amount);

    /// @dev State of a user's pending redemptions
    /// @param account Address that placed the order
    /// @return epoch The epoch of the redeem
    /// @return amount The amount of fund shares to redeem
    function userRedemptions(
        address account
    ) external view returns (uint256 epoch, uint256 amount);

    /// @dev Checks criteria for receiving fund shares
    /// @param account Address that placed the order
    /// @return canProcess Whether the order can be processed or not
    /// @return message The message for why the order can/can't be processed
    function canProcessDeposit(
        address account
    ) external returns (bool canProcess, string memory message);

    /// @dev Checks criteria for receiving `USDC`
    /// @param account Address that placed the order
    /// @return canProcess Whether the order can be processed or not
    /// @return message The message for why the order can/can't be processed
    function canProcessRedeem(
        address account
    ) external returns (bool canProcess, string memory message);

    /// @dev Checks that the address is a member of the whitelist
    /// @param account Address that placed the order
    /// @return _isWhitelisted Whether the address is a member of the whitelist
    function isWhitelisted(
        address account
    ) external view returns (bool _isWhitelisted);
}

contract OffchainFund is Ownable, AccessControl, ERC20, IOffchainFund {
    bytes32 public constant WHITELIST =
        keccak256(abi.encode("offchain.fund.whitelist"));

    uint8 public immutable DECIMAL_FACTOR;

    IERC20 public immutable usdc;

    bool public drained = false;

    uint256 public cap = 0;
    uint256 public min = 1e6;

    uint256 public epoch = 1;
    uint256 public currentPrice = 1e8;

    uint256 public tempMint = 0;
    uint256 public pendingDeposits = 0;
    uint256 public currentDeposits = 0;

    uint256 public tempBurn = 0;
    uint256 public pendingRedemptions = 0;
    uint256 public currentRedemptions = 0;

    uint256 public preDrainDepositCount = 0;
    uint256 public postDrainDepositCount = 0;

    uint256 public currentDepositCount = 0;

    mapping(address => Order) public userDeposits;
    mapping(address => Order) public userRedemptions;

    constructor(
        address owner,
        address usdc_,
        string memory name_,
        string memory symbol_
    ) ERC20(name_, symbol_) {
        _transferOwnership(owner);
        _grantRole(DEFAULT_ADMIN_ROLE, owner);

        usdc = IERC20(usdc_);

        DECIMAL_FACTOR = IERC20Metadata(usdc_).decimals();
    }

    /// @notice Transfer `USDC` to the contract
    /// @param assets Number of `USDC` tokens to be transferred to the contract
    function refill(uint256 assets) external {
        assert(usdc.transferFrom(_msgSender(), address(this), assets));

        emit Refill(_msgSender(), epoch, assets);
    }

    /// @notice Place order to receive fund shares by depositing `USDC`
    /// @param assets Number of `USDC` tokens to deposit
    function deposit(uint256 assets) external onlyRole(WHITELIST) {
        uint256 amount;
        uint256 balance;

        require(assets >= min, "deposit is less than the minimum");
        require(
            cap >= pendingDeposits + assets,
            "deposit would exceed epoch cap"
        );

        (bool valid, ) = _canProcessDeposit(_msgSender());
        require(!valid, "user has unprocessed userDeposits");

        balance = usdc.balanceOf(address(this));

        assert(usdc.transferFrom(_msgSender(), address(this), assets));

        // Ensure any fee taken on the transfer is accounted for

        amount = usdc.balanceOf(address(this)) - balance;

        // We restrict a user from adding to their deposit if they had made one
        // before `drain` was called.

        if (drained) {
            uint256 userEpoch = userDeposits[_msgSender()].epoch;

            require(
                userEpoch == 0 || userEpoch == epoch + 1,
                "cannot add to deposit after drain"
            );

            userDeposits[_msgSender()].epoch = epoch + 1;
            postDrainDepositCount = userDeposits[_msgSender()].amount == 0
                ? postDrainDepositCount + 1
                : postDrainDepositCount;
        } else {
            userDeposits[_msgSender()].epoch = epoch;
            preDrainDepositCount = userDeposits[_msgSender()].amount == 0
                ? preDrainDepositCount + 1
                : preDrainDepositCount;
        }

        pendingDeposits += amount;
        userDeposits[_msgSender()].amount += amount;

        emit Deposit(_msgSender(), epoch, amount);
    }

    /// @notice Process the batch of deposit orders for accounts to receive fund shares
    /// @param accountList Address list that placed orders
    function batchProcessDeposit(address[] calldata accountList) external {
        address account;

        uint256 length = accountList.length;
        for (uint256 i = 0; i < length; ++i) {
            account = accountList[i];
            (bool valid, ) = _canProcessDeposit(account);

            if (!valid) continue;

            _processDeposit(account);
        }
    }

    /// @notice Process the deposit order for account to receive fund shares
    /// @param account Address that placed the order
    function processDeposit(address account) external {
        (bool valid, string memory message) = _canProcessDeposit(account);
        require(valid, message);

        _processDeposit(account);
    }

    /// @notice Process the redeem order for an account to receive `USDC`
    /// @param account Address that placed the order
    function _processDeposit(address account) private {
        // sanity checks, should never fail, added just in case

        assert(currentPrice > 0);

        assert(currentDepositCount > 0);

        uint256 assets = userDeposits[account].amount;

        assert(currentDeposits >= assets);

        uint256 shares = (assets * 1e8 * 1e18) /
            (currentPrice * 10 ** DECIMAL_FACTOR);

        delete userDeposits[account];

        currentDepositCount--;
        currentDeposits -= assets;

        // Safety restriction to prevent overflow from rounding
        tempMint -= Math.min(shares, tempMint);

        address recipient = _isWhitelisted(account) ? account : owner();

        _mint(recipient, shares);

        emit ProcessDeposit(
            _msgSender(),
            recipient,
            epoch,
            shares,
            assets,
            currentPrice
        );
    }

    /// @notice Checks criteria for receiving fund shares
    /// @param account Address that placed the order
    /// @return bool Whether the order can be processed or not
    /// @return string The message for why the order can/can't be processed
    function canProcessDeposit(
        address account
    ) external view returns (bool, string memory) {
        return _canProcessDeposit(account);
    }

    /// @notice Checks criteria for receiving fund shares
    /// @param account Address that placed the order
    /// @return bool Whether the order can be processed or not
    /// @return string The message for why the order can/can't be processed
    function _canProcessDeposit(
        address account
    ) private view returns (bool, string memory) {
        if (userDeposits[account].epoch == 0)
            return (false, "account has no mint order");

        if (userDeposits[account].epoch >= epoch)
            return (false, "nav has not been updated for mint");

        return (true, "");
    }

    /// @notice Place order to receive `USDC` by burning fund shares
    /// @param shares Number of fund tokens to burn
    function redeem(uint256 shares) external onlyRole(WHITELIST) {
        (bool valid, ) = _canProcessRedeem(_msgSender());
        require(!valid, "user has unprocessed redemptions");

        _burnFrom(_msgSender(), shares);

        pendingRedemptions += shares;

        userRedemptions[_msgSender()].epoch = drained ? epoch + 1 : epoch;
        userRedemptions[_msgSender()].amount += shares;

        emit Redeem(_msgSender(), epoch, shares);
    }

    /// @notice Process the batch of redeem orders for accounts to receive `USDC`
    /// @param accountList Address list that placed orders
    function batchProcessRedeem(
        address[] calldata accountList
    ) external onlyOwner {
        address account;

        uint256 length = accountList.length;
        for (uint256 i = 0; i < length; ++i) {
            account = accountList[i];
            (bool valid, ) = _canProcessRedeem(account);

            if (!valid) continue;

            _processRedeem(account);
        }
    }

    /// @notice Process the redeem order for an account to receive `USDC`
    /// @param account Address that placed the order
    function processRedeem(address account) external onlyOwner {
        (bool valid, string memory message) = _canProcessRedeem(account);
        require(valid, message);

        _processRedeem(account);
    }

    /// @notice Process the redeem order for an account to receive `USDC`
    /// @param account Address that placed the order
    function _processRedeem(address account) private {
        uint256 shares = userRedemptions[account].amount;
        uint256 value = (shares * currentPrice) / 1e8;

        // sanity checks, should never fail, added just in case

        assert(currentRedemptions > 0);
        assert(currentRedemptions >= shares);

        uint256 contractsUsdcBalance = usdc.balanceOf(address(this));

        assert(contractsUsdcBalance > 0);

        uint256 balance = contractsUsdcBalance -
            Math.min(contractsUsdcBalance, pendingDeposits);

        uint256 available = (shares * balance * 1e18) /
            (currentRedemptions * 10 ** DECIMAL_FACTOR);

        currentRedemptions -= shares;

        address recipient = _isWhitelisted(account) ? account : owner();

        if (value > available) {
            /**
             *
             * This calculation can be done in one of two ways:
             *
             * 1) Take the percentage of the total value being redeemed and
             *    subract it from the order:
             *
             *    (amount * (value - available)) / value
             *
             * 2) Take the amount of tokens required to transfer out the amount
             *    of value the user is redeeming:
             *
             *    (available * 1e8) / currentPrice
             *
             * Both methods are mathematically identical since:
             *
             *    amount * (available / value)
             *       = amount * (available / (currentPrice * amount) / 1e8)
             *       = (available * 1e8) / currentPrice
             *
             */

            // Safety restriction to prevent overflow in case of rounding
            uint256 deduct = Math.min(
                (available * 1e8) / currentPrice,
                userRedemptions[account].amount
            );

            userRedemptions[account].epoch = epoch;
            userRedemptions[account].amount -= deduct;

            pendingRedemptions += userRedemptions[account].amount;

            // Safety restriction to prevent overflow from rounding
            available = Math.min(
                (available * 10 ** DECIMAL_FACTOR) / 1e18,
                contractsUsdcBalance
            );

            assert(usdc.transfer(recipient, available));

            emit ProcessRedeem(
                _msgSender(),
                recipient,
                epoch,
                deduct,
                available,
                currentPrice,
                false
            );

            return;
        }

        delete userRedemptions[account];

        // Safety restriction to prevent overflow in case of rounding
        value = Math.min(
            (value * 10 ** DECIMAL_FACTOR) / 1e18,
            contractsUsdcBalance
        );

        assert(usdc.transfer(recipient, value));

        emit ProcessRedeem(
            _msgSender(),
            recipient,
            epoch,
            shares,
            value,
            currentPrice,
            true
        );
    }

    /// @notice Checks criteria for receiving `USDC`
    /// @param account Address that placed the order
    /// @return bool Whether the order can be processed or not
    /// @return string The message for why the order can/can't be processed
    function canProcessRedeem(
        address account
    ) external view returns (bool, string memory) {
        return _canProcessRedeem(account);
    }

    /// @notice Checks criteria for receiving `USDC`
    /// @param account Address that placed the order
    /// @return bool Whether the order can be processed or not
    /// @return string The message for why the order can/can't be processed
    function _canProcessRedeem(
        address account
    ) private view returns (bool, string memory) {
        if (userRedemptions[account].epoch == 0)
            return (false, "account has no redeem order");

        if (userRedemptions[account].epoch >= epoch)
            return (false, "nav has not been updated for redeem");

        return (true, "");
    }

    /// @notice Pulls the maximum amount of available `USDC`
    function drain() external onlyOwner {
        require(!drained, "price has not been updated");

        drained = true;

        uint256 assets = pendingDeposits;

        currentDeposits += pendingDeposits;
        pendingDeposits = 0;

        uint256 shares = pendingRedemptions;

        currentRedemptions += pendingRedemptions;
        pendingRedemptions = 0;

        tempBurn = shares;

        assert(usdc.transfer(_msgSender(), assets));

        emit Drain(_msgSender(), epoch, assets, shares);
    }

    /// @notice Update the NAV per share for the fund and increment the epoch
    /// @param price New share price
    function update(uint256 price) external onlyOwner {
        require(price > 0, "price cannot be set to 0");
        require(drained, "user deposits have not been pulled");

        require(
            currentDepositCount == 0,
            "deposits have not been fully processed"
        );

        ++epoch;

        drained = false;
        currentPrice = price;

        currentDepositCount = preDrainDepositCount;
        preDrainDepositCount = postDrainDepositCount;
        postDrainDepositCount = 0;

        tempBurn = 0;
        tempMint =
            (currentDeposits * 1e8 * 1e18) /
            (currentPrice * 10 ** DECIMAL_FACTOR);

        emit Update(_msgSender(), epoch, currentPrice, totalShares());
    }

    /// @notice Net asset value of the fund
    /// @return uint256 Net asset value of the fund
    function nav() external view returns (uint256) {
        return (currentPrice * totalShares()) / 1e8;
    }

    /// @notice Total supply of shares
    /// @return uint256 Total supply of shares
    function totalShares() public view returns (uint256) {
        return tempMint + tempBurn + pendingRedemptions + totalSupply();
    }

    /// @notice Sets the limit on USDC accepted per epoch
    /// @param cap_ The new limit on deposits
    function adjustCap(uint256 cap_) external onlyOwner {
        cap = cap_;
    }

    /// @notice Sets the minimum deposit amount
    /// @param min_ The new minimum deposit
    function adjustMin(uint256 min_) external onlyOwner {
        min = min_;
    }

    /// @notice Adds an address to the whitelist
    /// @param account Address to add to the whitelist
    function addToWhitelist(address account) external {
        grantRole(WHITELIST, account);
    }

    /// @notice Process batch of addresses to be whitelisted
    /// @param accounts Address list to add to whitlist
    function batchAddToWhitelist(address[] calldata accounts) external {
        uint256 length = accounts.length;
        for (uint256 i = 0; i < length; ++i) {
            grantRole(WHITELIST, accounts[i]);
        }
    }

    /// @notice Process batch of addresses to be removed the whitelist
    /// @param account Address to remove from the whitelist
    function removeFromWhitelist(address account) external {
        revokeRole(WHITELIST, account);
    }

    /// @notice Process batch of addresses to be removed from whitelist
    /// @param accounts Address list to remove from whitlist
    function batchRemoveFromWhitelist(address[] calldata accounts) external {
        uint256 length = accounts.length;
        for (uint256 i = 0; i < length; ++i) {
            revokeRole(WHITELIST, accounts[i]);
        }
    }

    /// @notice Checks that the address is a member of the whitelist
    /// @param account Address that placed the order
    /// @return bool Whether the address is a member of the whitelist
    function isWhitelisted(address account) external view returns (bool) {
        return _isWhitelisted(account);
    }

    /// @notice Checks that the address is a member of the whitelist
    /// @param account Address that placed the order
    /// @return bool Whether the address is a member of the whitelist
    function _isWhitelisted(address account) private view returns (bool) {
        return hasRole(WHITELIST, account);
    }

    /// @notice transfer `ETH` to the sender/owner
    function recover() external onlyOwner {
        payable(_msgSender()).transfer(address(this).balance);
    }

    /// @notice transfer `ERC-20` tokens to the sender/owner
    /// @param token_ Asset transferred out
    /// @return bool Status of the transfer
    function recover(address token_) external onlyOwner returns (bool) {
        IERC20 token = IERC20(token_);

        return token.transfer(_msgSender(), token.balanceOf(address(this)));
    }

    function _beforeTokenTransfer(
        address from,
        address to,
        uint256
    ) internal override {
        require(
            to == address(0) || hasRole(WHITELIST, to),
            "receiver address is not in the whitelist"
        );

        require(
            from == address(0) || hasRole(WHITELIST, from),
            "sender address is not in the whitelist"
        );
    }

    function _burnFrom(address account, uint256 amount) private {
        _spendAllowance(account, address(this), amount);
        _burn(account, amount);
    }
}

File 2 of 14 : Math.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

    /**
     * @dev Returns the largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

    /**
     * @dev Returns the smallest of two numbers.
     */
    function min(uint256 a, uint256 b) internal pure returns (uint256) {
        return a < b ? a : b;
    }

    /**
     * @dev Returns the average of two numbers. The result is rounded towards
     * zero.
     */
    function average(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b) / 2 can overflow.
        return (a & b) + (a ^ b) / 2;
    }

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

    /**
     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
     * with further edits by Uniswap Labs also under MIT license.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator
    ) internal pure returns (uint256 result) {
        unchecked {
            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2^256 + prod0.
            uint256 prod0; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod0 := mul(x, y)
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1);

            ///////////////////////////////////////////////
            // 512 by 256 division.
            ///////////////////////////////////////////////

            // Make division exact by subtracting the remainder from [prod1 prod0].
            uint256 remainder;
            assembly {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                prod1 := sub(prod1, gt(remainder, prod0))
                prod0 := sub(prod0, remainder)
            }

            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
            // See https://cs.stackexchange.com/q/138556/92363.

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [prod1 prod0] by twos.
                prod0 := div(prod0, twos)

                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                twos := add(div(sub(0, twos), twos), 1)
            }

            // Shift in bits from prod1 into prod0.
            prod0 |= prod1 * twos;

            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv = 1 mod 2^4.
            uint256 inverse = (3 * denominator) ^ 2;

            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
            // in modular arithmetic, doubling the correct bits in each step.
            inverse *= 2 - denominator * inverse; // inverse mod 2^8
            inverse *= 2 - denominator * inverse; // inverse mod 2^16
            inverse *= 2 - denominator * inverse; // inverse mod 2^32
            inverse *= 2 - denominator * inverse; // inverse mod 2^64
            inverse *= 2 - denominator * inverse; // inverse mod 2^128
            inverse *= 2 - denominator * inverse; // inverse mod 2^256

            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
            // is no longer required.
            result = prod0 * inverse;
            return result;
        }
    }

    /**
     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator,
        Rounding rounding
    ) internal pure returns (uint256) {
        uint256 result = mulDiv(x, y, denominator);
        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
     *
     * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        if (a == 0) {
            return 0;
        }

        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
        //
        // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
        //
        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
        //
        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
        uint256 result = 1 << (log2(a) >> 1);

        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
        // into the expected uint128 result.
        unchecked {
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            return min(result, a / result);
        }
    }

    /**
     * @notice Calculates sqrt(a), following the selected rounding direction.
     */
    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = sqrt(a);
            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 128;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 64;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 32;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 16;
            }
            if (value >> 8 > 0) {
                value >>= 8;
                result += 8;
            }
            if (value >> 4 > 0) {
                value >>= 4;
                result += 4;
            }
            if (value >> 2 > 0) {
                value >>= 2;
                result += 2;
            }
            if (value >> 1 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log2(value);
            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 10, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >= 10**64) {
                value /= 10**64;
                result += 64;
            }
            if (value >= 10**32) {
                value /= 10**32;
                result += 32;
            }
            if (value >= 10**16) {
                value /= 10**16;
                result += 16;
            }
            if (value >= 10**8) {
                value /= 10**8;
                result += 8;
            }
            if (value >= 10**4) {
                value /= 10**4;
                result += 4;
            }
            if (value >= 10**2) {
                value /= 10**2;
                result += 2;
            }
            if (value >= 10**1) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log10(value);
            return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 256, rounded down, of a positive value.
     * Returns 0 if given 0.
     *
     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
     */
    function log256(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 16;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 8;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 4;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 2;
            }
            if (value >> 8 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
        }
    }
}

File 3 of 14 : Ownable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)

pragma solidity ^0.8.0;

import "../utils/Context.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * By default, the owner account will be the one that deploys the contract. This
 * can later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _transferOwnership(_msgSender());
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions anymore. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby removing any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

File 4 of 14 : AccessControl.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (access/AccessControl.sol)

pragma solidity ^0.8.0;

import "./IAccessControl.sol";
import "../utils/Context.sol";
import "../utils/Strings.sol";
import "../utils/introspection/ERC165.sol";

/**
 * @dev Contract module that allows children to implement role-based access
 * control mechanisms. This is a lightweight version that doesn't allow enumerating role
 * members except through off-chain means by accessing the contract event logs. Some
 * applications may benefit from on-chain enumerability, for those cases see
 * {AccessControlEnumerable}.
 *
 * Roles are referred to by their `bytes32` identifier. These should be exposed
 * in the external API and be unique. The best way to achieve this is by
 * using `public constant` hash digests:
 *
 * ```
 * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
 * ```
 *
 * Roles can be used to represent a set of permissions. To restrict access to a
 * function call, use {hasRole}:
 *
 * ```
 * function foo() public {
 *     require(hasRole(MY_ROLE, msg.sender));
 *     ...
 * }
 * ```
 *
 * Roles can be granted and revoked dynamically via the {grantRole} and
 * {revokeRole} functions. Each role has an associated admin role, and only
 * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
 *
 * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
 * that only accounts with this role will be able to grant or revoke other
 * roles. More complex role relationships can be created by using
 * {_setRoleAdmin}.
 *
 * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
 * grant and revoke this role. Extra precautions should be taken to secure
 * accounts that have been granted it.
 */
abstract contract AccessControl is Context, IAccessControl, ERC165 {
    struct RoleData {
        mapping(address => bool) members;
        bytes32 adminRole;
    }

    mapping(bytes32 => RoleData) private _roles;

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with a standardized message including the required role.
     *
     * The format of the revert reason is given by the following regular expression:
     *
     *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
     *
     * _Available since v4.1._
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
        return _roles[role].members[account];
    }

    /**
     * @dev Revert with a standard message if `_msgSender()` is missing `role`.
     * Overriding this function changes the behavior of the {onlyRole} modifier.
     *
     * Format of the revert message is described in {_checkRole}.
     *
     * _Available since v4.6._
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @dev Revert with a standard message if `account` is missing `role`.
     *
     * The format of the revert reason is given by the following regular expression:
     *
     *  /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert(
                string(
                    abi.encodePacked(
                        "AccessControl: account ",
                        Strings.toHexString(account),
                        " is missing role ",
                        Strings.toHexString(uint256(role), 32)
                    )
                )
            );
        }
    }

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
        return _roles[role].adminRole;
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleGranted} event.
     */
    function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
        _grantRole(role, account);
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleRevoked} event.
     */
    function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
        _revokeRole(role, account);
    }

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been revoked `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `account`.
     *
     * May emit a {RoleRevoked} event.
     */
    function renounceRole(bytes32 role, address account) public virtual override {
        require(account == _msgSender(), "AccessControl: can only renounce roles for self");

        _revokeRole(role, account);
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event. Note that unlike {grantRole}, this function doesn't perform any
     * checks on the calling account.
     *
     * May emit a {RoleGranted} event.
     *
     * [WARNING]
     * ====
     * This function should only be called from the constructor when setting
     * up the initial roles for the system.
     *
     * Using this function in any other way is effectively circumventing the admin
     * system imposed by {AccessControl}.
     * ====
     *
     * NOTE: This function is deprecated in favor of {_grantRole}.
     */
    function _setupRole(bytes32 role, address account) internal virtual {
        _grantRole(role, account);
    }

    /**
     * @dev Sets `adminRole` as ``role``'s admin role.
     *
     * Emits a {RoleAdminChanged} event.
     */
    function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
        bytes32 previousAdminRole = getRoleAdmin(role);
        _roles[role].adminRole = adminRole;
        emit RoleAdminChanged(role, previousAdminRole, adminRole);
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual {
        if (!hasRole(role, account)) {
            _roles[role].members[account] = true;
            emit RoleGranted(role, account, _msgSender());
        }
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual {
        if (hasRole(role, account)) {
            _roles[role].members[account] = false;
            emit RoleRevoked(role, account, _msgSender());
        }
    }
}

File 5 of 14 : ERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.0;

import "./IERC20.sol";
import "./extensions/IERC20Metadata.sol";
import "../../utils/Context.sol";

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 * For a generic mechanism see {ERC20PresetMinterPauser}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC20
 * applications.
 *
 * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
 * This allows applications to reconstruct the allowance for all accounts just
 * by listening to said events. Other implementations of the EIP may not emit
 * these events, as it isn't required by the specification.
 *
 * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
 * functions have been added to mitigate the well-known issues around setting
 * allowances. See {IERC20-approve}.
 */
contract ERC20 is Context, IERC20, IERC20Metadata {
    mapping(address => uint256) private _balances;

    mapping(address => mapping(address => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * The default value of {decimals} is 18. To select a different value for
     * {decimals} you should overload it.
     *
     * All two of these values are immutable: they can only be set once during
     * construction.
     */
    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual override returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual override returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the value {ERC20} uses, unless this function is
     * overridden;
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual override returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual override returns (uint256) {
        return _totalSupply;
    }

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual override returns (uint256) {
        return _balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `amount`.
     */
    function transfer(address to, uint256 amount) public virtual override returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, amount);
        return true;
    }

    /**
     * @dev See {IERC20-allowance}.
     */
    function allowance(address owner, address spender) public view virtual override returns (uint256) {
        return _allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 amount) public virtual override returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, amount);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `amount`.
     */
    function transferFrom(
        address from,
        address to,
        uint256 amount
    ) public virtual override returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, amount);
        _transfer(from, to, amount);
        return true;
    }

    /**
     * @dev Atomically increases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, allowance(owner, spender) + addedValue);
        return true;
    }

    /**
     * @dev Atomically decreases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `spender` must have allowance for the caller of at least
     * `subtractedValue`.
     */
    function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
        address owner = _msgSender();
        uint256 currentAllowance = allowance(owner, spender);
        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
        unchecked {
            _approve(owner, spender, currentAllowance - subtractedValue);
        }

        return true;
    }

    /**
     * @dev Moves `amount` of tokens from `from` to `to`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `from` must have a balance of at least `amount`.
     */
    function _transfer(
        address from,
        address to,
        uint256 amount
    ) internal virtual {
        require(from != address(0), "ERC20: transfer from the zero address");
        require(to != address(0), "ERC20: transfer to the zero address");

        _beforeTokenTransfer(from, to, amount);

        uint256 fromBalance = _balances[from];
        require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
        unchecked {
            _balances[from] = fromBalance - amount;
            // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
            // decrementing then incrementing.
            _balances[to] += amount;
        }

        emit Transfer(from, to, amount);

        _afterTokenTransfer(from, to, amount);
    }

    /** @dev Creates `amount` tokens and assigns them to `account`, increasing
     * the total supply.
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function _mint(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: mint to the zero address");

        _beforeTokenTransfer(address(0), account, amount);

        _totalSupply += amount;
        unchecked {
            // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
            _balances[account] += amount;
        }
        emit Transfer(address(0), account, amount);

        _afterTokenTransfer(address(0), account, amount);
    }

    /**
     * @dev Destroys `amount` tokens from `account`, reducing the
     * total supply.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     * - `account` must have at least `amount` tokens.
     */
    function _burn(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: burn from the zero address");

        _beforeTokenTransfer(account, address(0), amount);

        uint256 accountBalance = _balances[account];
        require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
        unchecked {
            _balances[account] = accountBalance - amount;
            // Overflow not possible: amount <= accountBalance <= totalSupply.
            _totalSupply -= amount;
        }

        emit Transfer(account, address(0), amount);

        _afterTokenTransfer(account, address(0), amount);
    }

    /**
     * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     */
    function _approve(
        address owner,
        address spender,
        uint256 amount
    ) internal virtual {
        require(owner != address(0), "ERC20: approve from the zero address");
        require(spender != address(0), "ERC20: approve to the zero address");

        _allowances[owner][spender] = amount;
        emit Approval(owner, spender, amount);
    }

    /**
     * @dev Updates `owner` s allowance for `spender` based on spent `amount`.
     *
     * Does not update the allowance amount in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Might emit an {Approval} event.
     */
    function _spendAllowance(
        address owner,
        address spender,
        uint256 amount
    ) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            require(currentAllowance >= amount, "ERC20: insufficient allowance");
            unchecked {
                _approve(owner, spender, currentAllowance - amount);
            }
        }
    }

    /**
     * @dev Hook that is called before any transfer of tokens. This includes
     * minting and burning.
     *
     * Calling conditions:
     *
     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * will be transferred to `to`.
     * - when `from` is zero, `amount` tokens will be minted for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address from,
        address to,
        uint256 amount
    ) internal virtual {}

    /**
     * @dev Hook that is called after any transfer of tokens. This includes
     * minting and burning.
     *
     * Calling conditions:
     *
     * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * has been transferred to `to`.
     * - when `from` is zero, `amount` tokens have been minted for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(
        address from,
        address to,
        uint256 amount
    ) internal virtual {}
}

File 6 of 14 : IAccessControl.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)

pragma solidity ^0.8.0;

/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControl {
    /**
     * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
     *
     * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
     * {RoleAdminChanged} not being emitted signaling this.
     *
     * _Available since v3.1._
     */
    event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);

    /**
     * @dev Emitted when `account` is granted `role`.
     *
     * `sender` is the account that originated the contract call, an admin role
     * bearer except when using {AccessControl-_setupRole}.
     */
    event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Emitted when `account` is revoked `role`.
     *
     * `sender` is the account that originated the contract call:
     *   - if using `revokeRole`, it is the admin role bearer
     *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
     */
    event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) external view returns (bool);

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {AccessControl-_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) external view returns (bytes32);

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function grantRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function revokeRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been granted `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `account`.
     */
    function renounceRole(bytes32 role, address account) external;
}

File 7 of 14 : IERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

    /**
     * @dev Returns the amount of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the amount of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves `amount` tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 amount) external returns (bool);

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 amount) external returns (bool);

    /**
     * @dev Moves `amount` tokens from `from` to `to` using the
     * allowance mechanism. `amount` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(
        address from,
        address to,
        uint256 amount
    ) external returns (bool);
}

File 8 of 14 : IERC20Metadata.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC20.sol";

/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 *
 * _Available since v4.1._
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the symbol of the token.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}

File 9 of 14 : IOffchainFundUser.sol
// SPDX-License-Identifier: BSL 1.1

pragma solidity ^0.8.13;

import {IERC20} from "openzeppelin-contracts/contracts/token/ERC20/IERC20.sol";

interface IOffchainFundUser {
    /// @dev Emitted when `USDC` is deposited to the fund
    /// @param sender The sender of the `USDC`
    /// @param epoch The epoch of the deposit
    /// @param assets The amount of `USDC` deposited
    event Deposit(
        address indexed sender,
        uint256 indexed epoch,
        uint256 assets
    );

    /// @dev Emitted when fund shares redeem order is placed
    /// @param sender The sender of the redeem order
    /// @param epoch The epoch of the redeem order
    /// @param shares The amount of fund shares to redeem
    event Redeem(address indexed sender, uint256 indexed epoch, uint256 shares);

    /// @dev The asset of the fund
    /// @return usdc `USDC` token
    function usdc() external view returns (IERC20 usdc);

    /// @dev Place order to receive fund shares by depositing `USDC`
    /// @param amount The amount of `USDC` to deposit
    function deposit(uint256 amount) external;

    /// @dev Place order to receive `USDC` by burning fund shares
    /// @param shares The amount of shares to redeem
    function redeem(uint256 shares) external;
}

File 10 of 14 : IOffchainFundAdmin.sol
// SPDX-License-Identifier: BSL 1.1

pragma solidity ^0.8.13;

interface IOffchainFundAdmin {
    /// @dev Emitted when the owner Refills the contract with USDC
    /// @param sender The sender of the `USDC`
    /// @param epoch The epoch of the refill
    /// @param assets The amount of `USDC` refilled
    event Refill(address indexed sender, uint256 indexed epoch, uint256 assets);

    /// @dev Emitted when the funds are drained from the contract
    /// @param sender The caller of the drain() function
    /// @param epoch The epoch of the drain
    /// @param assets The amount of `USDC` drained
    /// @param shares The amount of shares to be burned
    event Drain(
        address indexed sender,
        uint256 indexed epoch,
        uint256 assets,
        uint256 shares
    );

    /// @dev Emitted when the price is updated and the epoch starts
    /// @param sender The caller of the update() function
    /// @param epoch The epoch of the update
    /// @param price The new price of the share
    /// @param totalShares The total amount of shares available
    event Update(
        address indexed sender,
        uint256 indexed epoch,
        uint256 price,
        uint256 totalShares
    );

    /// @dev Emitted when the deposit order is processed
    /// @param sender The caller of the processDeposit() function
    /// @param account The account that placed the deposit order
    /// @param epoch The current epoch
    /// @param shares The amount of shares received
    /// @param assets The amount of `USDC` deposited
    /// @param price The price of the share
    event ProcessDeposit(
        address indexed sender,
        address indexed account,
        uint256 indexed epoch,
        uint256 shares,
        uint256 assets,
        uint256 price
    );

    /// @dev Emitted when the redeem order is processed
    /// @param sender The caller of the processRedeem() function
    /// @param account The account that placed the redeem order
    /// @param epoch The current epoch
    /// @param shares The amount of shares burned
    /// @param assets The amount of `USDC` received
    /// @param price The price of the share
    /// @param filled Whether the order was fully filled or not
    event ProcessRedeem(
        address indexed sender,
        address indexed account,
        uint256 indexed epoch,
        uint256 shares,
        uint256 assets,
        uint256 price,
        bool filled
    );

    /// @dev Total deposits submitted in the current epoch
    /// @return _pendingDeposits Total deposits submitted in the current epoch
    function pendingDeposits() external view returns (uint256 _pendingDeposits);

    /// @dev All passed passed available to be processed on a price update
    /// @return _currentDeposits All passed passed available to be processed on a price update
    function currentDeposits() external view returns (uint256 _currentDeposits);

    /// @dev Number of accounts with current deposits
    /// @return _currentDepositCount Number of accounts with current deposits
    function currentDepositCount()
        external
        view
        returns (uint256 _currentDepositCount);

    /// @dev Returns whether the Fund is drained (cut-off) of deposits or not
    /// @return _drained whether the Fund is drained (cut-off) of deposits or not
    function drained() external view returns (bool _drained);

    /// @dev Number of accounts with pre-drain deposits
    /// @return _preDrainDepositCount Number of accounts with pre-drain deposits
    function preDrainDepositCount()
        external
        view
        returns (uint256 _preDrainDepositCount);

    /// @dev Number of accounts with post-drain deposits
    /// @return _postDrainDepositCount Number of accounts with post-drain deposits
    function postDrainDepositCount()
        external
        view
        returns (uint256 _postDrainDepositCount);

    /// @dev Total redemptions submitted in the current epoch
    /// @return _pendingRedemptions Total redemptions submitted in the current epoch
    function pendingRedemptions()
        external
        view
        returns (uint256 _pendingRedemptions);

    /// @dev All passed redemptions available to be processed
    /// @return _currentRedemptions All passed redemptions available to be processed
    function currentRedemptions()
        external
        view
        returns (uint256 _currentRedemptions);

    /// @dev Sets the limit on USDC accepted per epoch
    /// @param cap_ The new limit on deposits
    function adjustCap(uint256 cap_) external;

    /// @dev Sets the minimum deposit amount
    /// @param min_ The new minimum deposit
    function adjustMin(uint256 min_) external;

    /// @dev Adds an address to the whitelist
    /// @param account Address to add to the whitelist
    function addToWhitelist(address account) external;

    /// @dev Removes address from the whitelist
    /// @param account Address to remove from the whitelist
    function removeFromWhitelist(address account) external;

    /// @dev Process batch of addresses to be whitelisted
    /// @param accounts Address list to add to whitlist
    function batchAddToWhitelist(address[] calldata accounts) external;

    /// @dev Process batch of addresses to be removed the whitelist
    /// @param accounts Address list to remove from the whitelist
    function batchRemoveFromWhitelist(address[] calldata accounts) external;

    /// @dev Pulls the maximum amount of available `USDC`
    function drain() external;

    /// @dev Update the NAV per share for the fund and increment the epoch
    /// @param price New share price
    function update(uint256 price) external;

    /// @dev Transfer `USDC` to the contract
    /// @param assets Number of `USDC` tokens to be transferred to the contract
    function refill(uint256 assets) external;

    /// @dev Process the redeem order for an account to receive `USDC`
    /// @param account Address that placed the order
    function processRedeem(address account) external;

    /// @dev Process the deposit order for account to receive fund shares
    /// @param account Address that placed the order
    function processDeposit(address account) external;

    /// @dev Process the batch of deposit orders for accounts to receive fund shares
    /// @param accountList Address list that placed orders
    function batchProcessDeposit(address[] calldata accountList) external;

    /// @dev Process the batch of redeem orders for accounts to receive `USDC`
    /// @param accountList Address list that placed orders
    function batchProcessRedeem(address[] calldata accountList) external;
}

File 11 of 14 : Context.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }
}

File 12 of 14 : Strings.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant _SYMBOLS = "0123456789abcdef";
    uint8 private constant _ADDRESS_LENGTH = 20;

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        unchecked {
            uint256 length = Math.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        unchecked {
            return toHexString(value, Math.log256(value) + 1);
        }
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        bytes memory buffer = new bytes(2 * length + 2);
        buffer[0] = "0";
        buffer[1] = "x";
        for (uint256 i = 2 * length + 1; i > 1; --i) {
            buffer[i] = _SYMBOLS[value & 0xf];
            value >>= 4;
        }
        require(value == 0, "Strings: hex length insufficient");
        return string(buffer);
    }

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
    }
}

File 13 of 14 : ERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)

pragma solidity ^0.8.0;

import "./IERC165.sol";

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
 * for the additional interface id that will be supported. For example:
 *
 * ```solidity
 * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
 *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
 * }
 * ```
 *
 * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

File 14 of 14 : IERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[EIP].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

Settings
{
  "remappings": [
    "ds-test/=lib/forge-std/lib/ds-test/src/",
    "erc4626-tests/=lib/openzeppelin-contracts/lib/erc4626-tests/",
    "forge-std/=lib/forge-std/src/",
    "openzeppelin-contracts/=lib/openzeppelin-contracts/"
  ],
  "optimizer": {
    "enabled": true,
    "runs": 200
  },
  "metadata": {
    "useLiteralContent": false,
    "bytecodeHash": "ipfs"
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "evmVersion": "london",
  "viaIR": false,
  "libraries": {}
}

Contract Security Audit

Contract ABI

[{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"usdc_","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Drain","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"price","type":"uint256"}],"name":"ProcessDeposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"price","type":"uint256"},{"indexed":false,"internalType":"bool","name":"filled","type":"bool"}],"name":"ProcessRedeem","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Redeem","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"}],"name":"Refill","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"uint256","name":"epoch","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"price","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"totalShares","type":"uint256"}],"name":"Update","type":"event"},{"inputs":[],"name":"DECIMAL_FACTOR","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WHITELIST","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"addToWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"cap_","type":"uint256"}],"name":"adjustCap","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"min_","type":"uint256"}],"name":"adjustMin","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"batchAddToWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accountList","type":"address[]"}],"name":"batchProcessDeposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accountList","type":"address[]"}],"name":"batchProcessRedeem","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"batchRemoveFromWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"canProcessDeposit","outputs":[{"internalType":"bool","name":"","type":"bool"},{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"canProcessRedeem","outputs":[{"internalType":"bool","name":"","type":"bool"},{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cap","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentDepositCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentDeposits","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentRedemptions","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"drain","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"drained","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"epoch","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"isWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"min","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nav","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingDeposits","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingRedemptions","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"postDrainDepositCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"preDrainDepositCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"processDeposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"processRedeem","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token_","type":"address"}],"name":"recover","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"recover","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"redeem","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"refill","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"removeFromWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tempBurn","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tempMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalShares","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"price","type":"uint256"}],"name":"update","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"usdc","outputs":[{"internalType":"contract IERC20","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"userDeposits","outputs":[{"internalType":"uint256","name":"epoch","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"userRedemptions","outputs":[{"internalType":"uint256","name":"epoch","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"}]

Deployed Bytecode

0x608060405234801561001057600080fd5b50600436106103ba5760003560e01c806382ab890a116101f4578063b6b55f251161011a578063dc686439116100ad578063f25579191161007c578063f25579191461080b578063f2fde38b1461081e578063f5a9bda214610831578063f88979451461083a57600080fd5b8063dc686439146107d3578063dd62ed3e146107dc578063e43252d7146107ef578063f06b23361461080257600080fd5b8063d547741f116100e9578063d547741f14610787578063d58d458a1461079a578063d6a61fc2146107ad578063db006a75146107c057600080fd5b8063b6b55f2514610751578063c1590cd714610764578063ca9d07ba1461076c578063ce7460241461077f57600080fd5b806395d89b4111610192578063a217fddf11610161578063a217fddf14610716578063a457c2d71461071e578063a664da9014610731578063a9059cbb1461073e57600080fd5b806395d89b41146106ea57806396cb1cfe146106f25780639890220b146107055780639d1b464a1461070d57600080fd5b80638da5cb5b116101ce5780638da5cb5b146106aa578063900cf0cf146106bb57806391d14854146106c4578063925ab1c9146106d757600080fd5b806382ab890a1461067b5780638ab1d6811461068e5780638cba8d06146106a157600080fd5b8063313ce567116102e45780633af32abf116102775780635c074f44116102465780635c074f441461063857806370a0823114610641578063715018a61461066a57806374402d211461067257600080fd5b80633af32abf146105b65780633e413bee146105c9578063425687ec146106085780634fc22caa1461062f57600080fd5b806336568abe116102b357806336568abe1461057f57806339509351146105925780633a98ef39146105a55780633ab15478146105ad57600080fd5b8063313ce567146105195780633219bbf01461052e57806333fdbbe51461054f578063355274ea1461057657600080fd5b80630f0a5c831161035c578063248a9ca31161032b578063248a9ca3146104c65780632db6fa36146104ea5780632f2ff15d146104fd57806330c9efd11461051057600080fd5b80630f0a5c831461048657806318160ddd146104995780631bb7cc99146104ab57806323b872dd146104b357600080fd5b806306fdde031161039857806306fdde031461040f578063095ea7b3146104245780630ba36dcd146104375780630cd865ec1461047357600080fd5b806301ffc9a7146103bf57806304458aa8146103e7578063045fb888146103fc575b600080fd5b6103d26103cd366004612d68565b610843565b60405190151581526020015b60405180910390f35b6103fa6103f5366004612d92565b61087a565b005b6103fa61040a366004612d92565b6108f3565b610417610964565b6040516103de9190612e5f565b6103d2610432366004612e89565b6109f6565b61045e610445366004612eb3565b6015602052600090815260409020805460019091015482565b604080519283526020830191909152016103de565b6103d2610481366004612eb3565b610a0e565b6103fa610494366004612eb3565b610b09565b6004545b6040519081526020016103de565b61049d610b59565b6103d26104c1366004612ece565b610b81565b61049d6104d4366004612f0a565b6000908152600160208190526040909120015490565b6103fa6104f8366004612d92565b610ba5565b6103fa61050b366004612f23565b610c10565b61049d60135481565b60125b60405160ff90911681526020016103de565b61054161053c366004612eb3565b610c36565b6040516103de929190612f4f565b61051c7f000000000000000000000000000000000000000000000000000000000000000681565b61049d60085481565b6103fa61058d366004612f23565b610c4c565b6103d26105a0366004612e89565b610cca565b61049d610cec565b61049d60105481565b6103d26105c4366004612eb3565b610d23565b6105f07f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4881565b6040516001600160a01b0390911681526020016103de565b61045e610616366004612eb3565b6016602052600090815260409020805460019091015482565b61049d60125481565b61049d600d5481565b61049d61064f366004612eb3565b6001600160a01b031660009081526002602052604090205490565b6103fa610d2e565b61049d600c5481565b6103fa610689366004612f0a565b610d42565b6103fa61069c366004612eb3565b610f4c565b61049d600f5481565b6000546001600160a01b03166105f0565b61049d600a5481565b6103d26106d2366004612f23565b610f7d565b6103fa6106e5366004612d92565b610fa8565b610417611012565b6103fa610700366004612eb3565b611021565b6103fa61105b565b61049d600b5481565b61049d600081565b6103d261072c366004612e89565b6111fb565b6007546103d29060ff1681565b6103d261074c366004612e89565b611276565b6103fa61075f366004612f0a565b611284565b61049d611727565b6103fa61077a366004612f0a565b61174d565b6103fa611835565b6103fa610795366004612f23565b611869565b6103fa6107a8366004612f0a565b61188f565b6105416107bb366004612eb3565b61189c565b6103fa6107ce366004612f0a565b6118a9565b61049d600e5481565b61049d6107ea366004612f72565b6119de565b6103fa6107fd366004612eb3565b611a09565b61049d60145481565b6103fa610819366004612f0a565b611a37565b6103fa61082c366004612eb3565b611a44565b61049d60115481565b61049d60095481565b60006001600160e01b03198216637965db0b60e01b148061087457506301ffc9a760e01b6001600160e01b03198316145b92915050565b610882611aba565b600081815b818110156108ec578484828181106108a1576108a1612f9c565b90506020020160208101906108b69190612eb3565b925060006108c384611b14565b509050806108d157506108dc565b6108da84611bd2565b505b6108e581612fc8565b9050610887565b5050505050565b8060005b8181101561095e5761094e60405160200161091190612fe1565b6040516020818303038152906040528051906020012085858481811061093957610939612f9c565b90506020020160208101906107959190612eb3565b61095781612fc8565b90506108f7565b50505050565b60606005805461097390613018565b80601f016020809104026020016040519081016040528092919081815260200182805461099f90613018565b80156109ec5780601f106109c1576101008083540402835291602001916109ec565b820191906000526020600020905b8154815290600101906020018083116109cf57829003601f168201915b5050505050905090565b600033610a04818585612116565b5060019392505050565b6000610a18611aba565b816001600160a01b03811663a9059cbb336040516370a0823160e01b81523060048201526001600160a01b038516906370a0823190602401602060405180830381865afa158015610a6d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a919190613052565b6040516001600160e01b031960e085901b1681526001600160a01b03909216600483015260248201526044016020604051808303816000875af1158015610adc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b00919061306b565b9150505b919050565b610b11611aba565b600080610b1d83611b14565b91509150818190610b4a5760405162461bcd60e51b8152600401610b419190612e5f565b60405180910390fd5b50610b5483611bd2565b505050565b604051602001610b6890612fe1565b6040516020818303038152906040528051906020012081565b600033610b8f858285612232565b610b9a8585856122a6565b506001949350505050565b8060005b8181101561095e57610c00604051602001610bc390612fe1565b60405160208183030381529060405280519060200120858584818110610beb57610beb612f9c565b905060200201602081019061050b9190612eb3565b610c0981612fc8565b9050610ba9565b60008281526001602081905260409091200154610c2c8161245c565b610b548383612466565b60006060610c43836124d1565b91509150915091565b6001600160a01b0381163314610cbc5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610b41565b610cc68282612576565b5050565b600033610a04818585610cdd83836119de565b610ce7919061308d565b612116565b6000610cf760045490565b601054600f54600c54610d0a919061308d565b610d14919061308d565b610d1e919061308d565b905090565b6000610874826125dd565b610d36611aba565b610d40600061260d565b565b610d4a611aba565b60008111610d9a5760405162461bcd60e51b815260206004820152601860248201527f70726963652063616e6e6f742062652073657420746f203000000000000000006044820152606401610b41565b60075460ff16610df75760405162461bcd60e51b815260206004820152602260248201527f75736572206465706f736974732068617665206e6f74206265656e2070756c6c604482015261195960f21b6064820152608401610b41565b60145415610e565760405162461bcd60e51b815260206004820152602660248201527f6465706f736974732068617665206e6f74206265656e2066756c6c792070726f60448201526518d95cdcd95960d21b6064820152608401610b41565b600a60008154610e6590612fc8565b909155506007805460ff19169055600b8190556012805460145560138054909155600090819055600f55610eba7f0000000000000000000000000000000000000000000000000000000000000006600a613189565b600b54610ec79190613198565b600e54610ed8906305f5e100613198565b610eea90670de0b6b3a7640000613198565b610ef491906131b7565b600c55600a54336001600160a01b03167f96ca5813fd6a7ce6930a4f31eb077b2cb8e92e497a52cc5d763773e80b6ec703600b54610f30610cec565b604080519283526020830191909152015b60405180910390a350565b610f7a604051602001610f5e90612fe1565b6040516020818303038152906040528051906020012082611869565b50565b60009182526001602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600081815b818110156108ec57848482818110610fc757610fc7612f9c565b9050602002016020810190610fdc9190612eb3565b92506000610fe9846124d1565b50905080610ff75750611002565b6110008461265d565b505b61100b81612fc8565b9050610fad565b60606006805461097390613018565b60008061102d836124d1565b915091508181906110515760405162461bcd60e51b8152600401610b419190612e5f565b50610b548361265d565b611063611aba565b60075460ff16156110b65760405162461bcd60e51b815260206004820152601a60248201527f707269636520686173206e6f74206265656e20757064617465640000000000006044820152606401610b41565b6007805460ff19166001179055600d54600e80548291906000906110db90849061308d565b90915550506000600d81905560105460118054919283926110fd90849061308d565b90915550506000601055600f8190557f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb486001600160a01b031663a9059cbb336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602481018590526044016020604051808303816000875af1158015611189573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111ad919061306b565b6111b9576111b96131d9565b600a54604080518481526020810184905233917f822847fe5fcee6e9adf194ec9004a16e31c4eceffbda92c7b046a56174b22f19910160405180910390a35050565b6000338161120982866119de565b9050838110156112695760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610b41565b610b9a8286868403612116565b600033610a048185856122a6565b60405160200161129390612fe1565b604051602081830303815290604052805190602001206112b28161245c565b6000806009548410156113075760405162461bcd60e51b815260206004820181905260248201527f6465706f736974206973206c657373207468616e20746865206d696e696d756d6044820152606401610b41565b83600d54611315919061308d565b60085410156113665760405162461bcd60e51b815260206004820152601e60248201527f6465706f73697420776f756c64206578636565642065706f63682063617000006044820152606401610b41565b6000611371336124d1565b50905080156113cc5760405162461bcd60e51b815260206004820152602160248201527f757365722068617320756e70726f63657373656420757365724465706f7369746044820152607360f81b6064820152608401610b41565b6040516370a0823160e01b81523060048201527f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb486001600160a01b0316906370a0823190602401602060405180830381865afa158015611430573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114549190613052565b91506001600160a01b037f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48166323b872dd336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152306024820152604481018890526064016020604051808303816000875af11580156114d9573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114fd919061306b565b611509576115096131d9565b6040516370a0823160e01b815230600482015282907f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb486001600160a01b0316906370a0823190602401602060405180830381865afa15801561156f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115939190613052565b61159d91906131ef565b60075490935060ff161561167257336000908152601560205260409020548015806115d45750600a546115d190600161308d565b81145b61162a5760405162461bcd60e51b815260206004820152602160248201527f63616e6e6f742061646420746f206465706f73697420616674657220647261696044820152603760f91b6064820152608401610b41565b600a5461163890600161308d565b336000908152601560205260409020908155600101541561165b57601354611669565b60135461166990600161308d565b601355506116aa565b600a543360009081526015602052604090209081556001015415611698576012546116a6565b6012546116a690600161308d565b6012555b82600d60008282546116bc919061308d565b909155505033600090815260156020526040812060010180548592906116e390849061308d565b9091555050600a5460405184815233907f90890809c654f11d6e72a28fa60149770a0d11ec6c92319d6ceb2bb0a4ea1a159060200160405180910390a35050505050565b60006305f5e100611736610cec565b600b546117439190613198565b610d1e91906131b7565b6001600160a01b037f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48166323b872dd336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152306024820152604481018490526064016020604051808303816000875af11580156117d0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906117f4919061306b565b611800576118006131d9565b600a5460405182815233907fe5ed0451c3c49e91c18ea603cfa7cd0833f466abb605e6e8a5964c5ffa453cde90602001610f41565b61183d611aba565b60405133904780156108fc02916000818181858888f19350505050158015610f7a573d6000803e3d6000fd5b600082815260016020819052604090912001546118858161245c565b610b548383612576565b611897611aba565b600855565b60006060610c4383611b14565b6040516020016118b890612fe1565b604051602081830303815290604052805190602001206118d78161245c565b60006118e233611b14565b50905080156119335760405162461bcd60e51b815260206004820181905260248201527f757365722068617320756e70726f63657373656420726564656d7074696f6e736044820152606401610b41565b61193d338461280d565b826010600082825461194f919061308d565b909155505060075460ff1661196657600a54611974565b600a5461197490600161308d565b3360009081526016602052604081209182556001909101805485929061199b90849061308d565b9091555050600a5460405184815233907fe5b754fb1abb7f01b499791d0b820ae3b6af3424ac1c59768edb53f4ec31a929906020015b60405180910390a3505050565b6001600160a01b03918216600090815260036020908152604080832093909416825291909152205490565b610f7a604051602001611a1b90612fe1565b6040516020818303038152906040528051906020012082610c10565b611a3f611aba565b600955565b611a4c611aba565b6001600160a01b038116611ab15760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610b41565b610f7a8161260d565b6000546001600160a01b03163314610d405760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610b41565b6001600160a01b0381166000908152601660205260408120546060908203611b7457505060408051808201909152601b81527f6163636f756e7420686173206e6f2072656465656d206f7264657200000000006020820152600092909150565b600a546001600160a01b03841660009081526016602052604090205410611bb95760006040518060600160405280602381526020016132ca6023913991509150915091565b5050604080516020810190915260008152600192909150565b6001600160a01b038116600090815260166020526040812060010154600b549091906305f5e10090611c049084613198565b611c0e91906131b7565b9050600060115411611c2257611c226131d9565b816011541015611c3457611c346131d9565b6040516370a0823160e01b81523060048201526000907f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb486001600160a01b0316906370a0823190602401602060405180830381865afa158015611c9b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611cbf9190613052565b905060008111611cd157611cd16131d9565b6000611cdf82600d54612822565b611ce990836131ef565b90506000611d187f0000000000000000000000000000000000000000000000000000000000000006600a613189565b601154611d259190613198565b611d2f8387613198565b611d4190670de0b6b3a7640000613198565b611d4b91906131b7565b90508460116000828254611d5f91906131ef565b9091555060009050611d70876125dd565b611d85576000546001600160a01b0316611d87565b865b905081851115611f9f576000611dd4600b54846305f5e100611da99190613198565b611db391906131b7565b6001600160a01b038a16600090815260166020526040902060010154612822565b600a546001600160a01b038a166000908152601660205260408120918255600190910180549293508392909190611e0c9084906131ef565b90915550506001600160a01b0388166000908152601660205260408120600101546010805491929091611e4090849061308d565b90915550611e979050670de0b6b3a7640000611e7d7f0000000000000000000000000000000000000000000000000000000000000006600a613189565b611e879086613198565b611e9191906131b7565b86612822565b60405163a9059cbb60e01b81526001600160a01b038481166004830152602482018390529194507f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb489091169063a9059cbb906044016020604051808303816000875af1158015611f0b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f2f919061306b565b611f3b57611f3b6131d9565b600a54600b5460408051848152602081018790528082019290925260006060830152516001600160a01b0385169133917fff576281f29d565301cfcc89843d79bc78dfcac4b4537694a809419c180f403e9181900360800190a45050505050505050565b6001600160a01b03871660009081526016602052604081208181556001015561200f670de0b6b3a7640000611ff57f0000000000000000000000000000000000000000000000000000000000000006600a613189565b611fff9088613198565b61200991906131b7565b85612822565b60405163a9059cbb60e01b81526001600160a01b038381166004830152602482018390529196507f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb489091169063a9059cbb906044016020604051808303816000875af1158015612083573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906120a7919061306b565b6120b3576120b36131d9565b600a54600b5460408051898152602081018990528082019290925260016060830152516001600160a01b0384169133917fff576281f29d565301cfcc89843d79bc78dfcac4b4537694a809419c180f403e9181900360800190a450505050505050565b6001600160a01b0383166121785760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610b41565b6001600160a01b0382166121d95760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610b41565b6001600160a01b0383811660008181526003602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591016119d1565b600061223e84846119de565b9050600019811461095e57818110156122995760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610b41565b61095e8484848403612116565b6001600160a01b03831661230a5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610b41565b6001600160a01b03821661236c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610b41565b61237783838361283a565b6001600160a01b038316600090815260026020526040902054818110156123ef5760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610b41565b6001600160a01b0380851660008181526002602052604080822086860390559286168082529083902080548601905591517fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9061244f9086815260200190565b60405180910390a361095e565b610f7a8133612954565b6124708282610f7d565b610cc65760008281526001602081815260408084206001600160a01b0386168086529252808420805460ff19169093179092559051339285917f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d9190a45050565b6001600160a01b038116600090815260156020526040812054606090820361253157505060408051808201909152601981527f6163636f756e7420686173206e6f206d696e74206f72646572000000000000006020820152600092909150565b600a546001600160a01b03841660009081526015602052604090205410611bb95760006040518060600160405280602181526020016132a96021913991509150915091565b6125808282610f7d565b15610cc65760008281526001602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b60006108746040516020016125f190612fe1565b6040516020818303038152906040528051906020012083610f7d565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000600b541161266f5761266f6131d9565b600060145411612681576126816131d9565b6001600160a01b038116600090815260156020526040902060010154600e548111156126af576126af6131d9565b60006126dc7f0000000000000000000000000000000000000000000000000000000000000006600a613189565b600b546126e99190613198565b6126f7836305f5e100613198565b61270990670de0b6b3a7640000613198565b61271391906131b7565b6001600160a01b0384166000908152601560205260408120818155600101819055601480549293509061274583613206565b919050555081600e600082825461275c91906131ef565b9250508190555061276f81600c54612822565b600c600082825461278091906131ef565b9091555060009050612791846125dd565b6127a6576000546001600160a01b03166127a8565b835b90506127b481836129ad565b600a54600b54604080518581526020810187905280820192909252516001600160a01b0384169133917f6e83ae798cedaea7f39a2b3704366131af236270e3084de705847b7bfba457839181900360600190a450505050565b612818823083612232565b610cc68282612a7a565b60008183106128315781612833565b825b9392505050565b6001600160a01b038216158061285d575061285d6040516020016125f190612fe1565b6128ba5760405162461bcd60e51b815260206004820152602860248201527f72656365697665722061646472657373206973206e6f7420696e2074686520776044820152671a1a5d195b1a5cdd60c21b6064820152608401610b41565b6001600160a01b03831615806128f957506128f96040516020016128dd90612fe1565b6040516020818303038152906040528051906020012084610f7d565b610b545760405162461bcd60e51b815260206004820152602660248201527f73656e6465722061646472657373206973206e6f7420696e20746865207768696044820152651d195b1a5cdd60d21b6064820152608401610b41565b61295e8282610f7d565b610cc65761296b81612bba565b612976836020612bcc565b60405160200161298792919061321d565b60408051601f198184030181529082905262461bcd60e51b8252610b4191600401612e5f565b6001600160a01b038216612a035760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610b41565b612a0f6000838361283a565b8060046000828254612a21919061308d565b90915550506001600160a01b0382166000818152600260209081526040808320805486019055518481527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a35050565b6001600160a01b038216612ada5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610b41565b612ae68260008361283a565b6001600160a01b03821660009081526002602052604090205481811015612b5a5760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610b41565b6001600160a01b03831660008181526002602090815260408083208686039055600480548790039055518581529192917fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef910160405180910390a3505050565b60606108746001600160a01b03831660145b60606000612bdb836002613198565b612be690600261308d565b67ffffffffffffffff811115612bfe57612bfe613292565b6040519080825280601f01601f191660200182016040528015612c28576020820181803683370190505b509050600360fc1b81600081518110612c4357612c43612f9c565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110612c7257612c72612f9c565b60200101906001600160f81b031916908160001a9053506000612c96846002613198565b612ca190600161308d565b90505b6001811115612d19576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110612cd557612cd5612f9c565b1a60f81b828281518110612ceb57612ceb612f9c565b60200101906001600160f81b031916908160001a90535060049490941c93612d1281613206565b9050612ca4565b5083156128335760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610b41565b600060208284031215612d7a57600080fd5b81356001600160e01b03198116811461283357600080fd5b60008060208385031215612da557600080fd5b823567ffffffffffffffff80821115612dbd57600080fd5b818501915085601f830112612dd157600080fd5b813581811115612de057600080fd5b8660208260051b8501011115612df557600080fd5b60209290920196919550909350505050565b60005b83811015612e22578181015183820152602001612e0a565b8381111561095e5750506000910152565b60008151808452612e4b816020860160208601612e07565b601f01601f19169290920160200192915050565b6020815260006128336020830184612e33565b80356001600160a01b0381168114610b0457600080fd5b60008060408385031215612e9c57600080fd5b612ea583612e72565b946020939093013593505050565b600060208284031215612ec557600080fd5b61283382612e72565b600080600060608486031215612ee357600080fd5b612eec84612e72565b9250612efa60208501612e72565b9150604084013590509250925092565b600060208284031215612f1c57600080fd5b5035919050565b60008060408385031215612f3657600080fd5b82359150612f4660208401612e72565b90509250929050565b8215158152604060208201526000612f6a6040830184612e33565b949350505050565b60008060408385031215612f8557600080fd5b612f8e83612e72565b9150612f4660208401612e72565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201612fda57612fda612fb2565b5060010190565b60208082526017908201527f6f6666636861696e2e66756e642e77686974656c697374000000000000000000604082015260600190565b600181811c9082168061302c57607f821691505b60208210810361304c57634e487b7160e01b600052602260045260246000fd5b50919050565b60006020828403121561306457600080fd5b5051919050565b60006020828403121561307d57600080fd5b8151801515811461283357600080fd5b600082198211156130a0576130a0612fb2565b500190565b600181815b808511156130e05781600019048211156130c6576130c6612fb2565b808516156130d357918102915b93841c93908002906130aa565b509250929050565b6000826130f757506001610874565b8161310457506000610874565b816001811461311a576002811461312457613140565b6001915050610874565b60ff84111561313557613135612fb2565b50506001821b610874565b5060208310610133831016604e8410600b8410161715613163575081810a610874565b61316d83836130a5565b806000190482111561318157613181612fb2565b029392505050565b600061283360ff8416836130e8565b60008160001904831182151516156131b2576131b2612fb2565b500290565b6000826131d457634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052600160045260246000fd5b60008282101561320157613201612fb2565b500390565b60008161321557613215612fb2565b506000190190565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613255816017850160208801612e07565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613286816028840160208801612e07565b01602801949350505050565b634e487b7160e01b600052604160045260246000fdfe6e617620686173206e6f74206265656e207570646174656420666f72206d696e746e617620686173206e6f74206265656e207570646174656420666f722072656465656da264697066735822122012857b0fe3f6b31d2ac1ed04e02985538eae58df7582b7b7db68869cca26b65464736f6c634300080e0033

Block Transaction Difficulty Gas Used Reward
View All Blocks Produced

Block Uncle Number Difficulty Gas Used Reward
View All Uncles
Loading...
Loading
Loading...
Loading

Validator Index Block Amount
View All Withdrawals

Transaction Hash Block Value Eth2 PubKey Valid
View All Deposits
Loading...
Loading
[ Download: CSV Export  ]

A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.