Overview
ETH Balance
0 ETH
Eth Value
$0.00More Info
Private Name Tags
ContractCreator
View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Loading...
Loading
Contract Name:
UsualX
Compiler Version
v0.8.20+commit.a1b79de6
Optimization Enabled:
Yes with 200 runs
Other Settings:
shanghai EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
//SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; import {SafeERC20} from "openzeppelin-contracts/token/ERC20/utils/SafeERC20.sol"; import {IERC20} from "openzeppelin-contracts/token/ERC20/extensions/ERC4626.sol"; import {IERC20Permit} from "openzeppelin-contracts/token/ERC20/extensions/IERC20Permit.sol"; import {ERC20Upgradeable} from "openzeppelin-contracts-upgradeable/token/ERC20/ERC20Upgradeable.sol"; import {PausableUpgradeable} from "openzeppelin-contracts-upgradeable/utils/PausableUpgradeable.sol"; import {ReentrancyGuardUpgradeable} from "openzeppelin-contracts-upgradeable/utils/ReentrancyGuardUpgradeable.sol"; import {Math} from "openzeppelin-contracts/utils/math/Math.sol"; import {EIP712Upgradeable} from "openzeppelin-contracts-upgradeable/utils/cryptography/EIP712Upgradeable.sol"; import {IRegistryAccess} from "src/interfaces/registry/IRegistryAccess.sol"; import {IRegistryContract} from "src/interfaces/registry/IRegistryContract.sol"; import {Normalize} from "src/utils/normalize.sol"; import {CheckAccessControl} from "src/utils/CheckAccessControl.sol"; import {YieldBearingVault} from "src/vaults/YieldBearingVault.sol"; import { CONTRACT_REGISTRY_ACCESS, CONTRACT_USUAL, CONTRACT_DISTRIBUTION_MODULE, DEFAULT_ADMIN_ROLE, BLACKLIST_ROLE, WITHDRAW_FEE_UPDATER_ROLE, PAUSING_CONTRACTS_ROLE, BASIS_POINT_BASE, MAX_25_PERCENT_WITHDRAW_FEE, YIELD_PRECISION } from "src/constants.sol"; import { NullContract, NotAuthorized, NullAddress, AmountTooBig, Blacklisted, SameValue, ZeroYieldAmount, StartTimeNotInFuture, CurrentTimeBeforePeriodFinish, EndTimeNotAfterStartTime, InsufficientAssetsForYield, StartTimeBeforePeriodFinish } from "src/errors.sol"; contract UsualX is YieldBearingVault, PausableUpgradeable, ReentrancyGuardUpgradeable, EIP712Upgradeable { using SafeERC20 for IERC20; using Normalize for uint256; using CheckAccessControl for IRegistryAccess; // Event emitted when an address is blacklisted // @param account The address that was blacklisted event Blacklist(address account); // Event emitted when an address is removed from the blacklist // @param account The address that was removed from the blacklist event UnBlacklist(address account); // Event emitted when the withdrawal fee is updated // @param newWithdrawFeeBps The new withdrawal fee in basis points event WithdrawFeeUpdated(uint256 newWithdrawFeeBps); //@custom:storage-location erc7201:usualX.storage.v0 struct UsualXStorageV0 { /// @notice The fee charged on withdrawals uint256 withdrawFeeBps; /// @notice The RegistryAccess contract instance for role checks. IRegistryAccess registryAccess; /// @notice The RegistryContract instance for contract interactions. IRegistryContract registryContract; /// @notice The blacklisted users mapping mapping(address => bool) isBlacklisted; } // keccak256(abi.encode(uint256(keccak256("usualX.storage.v0")) - 1)) & ~bytes32(uint256(0xff)) // solhint-disable-next-line bytes32 public constant UsualXStorageV0Location = 0xe34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b96795300; /// @notice Returns the storage struct of the contract. /// @return $ The pointer to the storage struct of the contract. function _usualXStorageV0() internal pure returns (UsualXStorageV0 storage $) { bytes32 position = UsualXStorageV0Location; // solhint-disable-next-line no-inline-assembly assembly { $.slot := position } } /// @custom:oz-upgrades-unsafe-allow constructor constructor() { _disableInitializers(); } /*////////////////////////////////////////////////////////////// INITIALIZER //////////////////////////////////////////////////////////////*/ /// @notice Initializes the UsualX contract. /// @param _registryContract The address of the RegistryContract. /// @param _withdrawFeeBps The withdrawal fee in basis points. /// @param _name The name of the token. /// @param _symbol The symbol of the token. function initialize( address _registryContract, uint256 _withdrawFeeBps, string memory _name, string memory _symbol ) external initializer { if (_registryContract == address(0)) { revert NullContract(); } UsualXStorageV0 storage $ = _usualXStorageV0(); $.registryContract = IRegistryContract(_registryContract); address _underlyingToken = $.registryContract.getContract(CONTRACT_USUAL); __YieldBearingVault_init(_underlyingToken, _name, _symbol); __Pausable_init_unchained(); __ReentrancyGuard_init(); __EIP712_init_unchained(_name, "1"); if (_withdrawFeeBps > MAX_25_PERCENT_WITHDRAW_FEE) { revert AmountTooBig(); } $.withdrawFeeBps = _withdrawFeeBps; $.registryAccess = IRegistryAccess( IRegistryContract(_registryContract).getContract(CONTRACT_REGISTRY_ACCESS) ); } /// @notice Pauses the contract. /// @dev Can be called by the pauser to pause some contract operations. function pause() external { UsualXStorageV0 storage $ = _usualXStorageV0(); $.registryAccess.onlyMatchingRole(PAUSING_CONTRACTS_ROLE); _pause(); } /// @notice Unpauses the contract. /// @dev Can be called by the admin to unpause some contract operations. function unpause() external { UsualXStorageV0 storage $ = _usualXStorageV0(); $.registryAccess.onlyMatchingRole(DEFAULT_ADMIN_ROLE); _unpause(); } /// @notice Adds an address to the blacklist. /// @dev Can only be called by the admin. /// @param account The address to be blacklisted. function blacklist(address account) external { if (account == address(0)) { revert NullAddress(); } UsualXStorageV0 storage $ = _usualXStorageV0(); $.registryAccess.onlyMatchingRole(BLACKLIST_ROLE); if ($.isBlacklisted[account]) { revert SameValue(); } $.isBlacklisted[account] = true; emit Blacklist(account); } /// @notice Removes an address from the blacklist. /// @dev Can only be called by the admin. /// @param account The address to be removed from the blacklist. function unBlacklist(address account) external { UsualXStorageV0 storage $ = _usualXStorageV0(); $.registryAccess.onlyMatchingRole(BLACKLIST_ROLE); if (!$.isBlacklisted[account]) { revert SameValue(); } $.isBlacklisted[account] = false; emit UnBlacklist(account); } /// @notice Checks if an address is blacklisted. /// @param account The address to check. /// @return bool True if the address is blacklisted. function isBlacklisted(address account) external view returns (bool) { UsualXStorageV0 storage $ = _usualXStorageV0(); return $.isBlacklisted[account]; } /// @notice Hook that ensures token transfers are not made from or to not blacklisted addresses. /// @param from The address sending the tokens. /// @param to The address receiving the tokens. /// @param amount The amount of tokens being transferred. function _update(address from, address to, uint256 amount) internal override(ERC20Upgradeable) { UsualXStorageV0 storage $ = _usualXStorageV0(); if ($.isBlacklisted[from] || $.isBlacklisted[to]) { revert Blacklisted(); } super._update(from, to, amount); } /// @notice Starts a new yield distribution period /// @dev Can only be called by the distribution contract /// @param yieldAmount The amount of yield to distribute /// @param startTime The start time of the new yield period /// @param endTime The end time of the new yield period function startYieldDistribution(uint256 yieldAmount, uint256 startTime, uint256 endTime) external { UsualXStorageV0 storage $ = _usualXStorageV0(); if (msg.sender != $.registryContract.getContract(CONTRACT_DISTRIBUTION_MODULE)) { revert NotAuthorized(); } _startYieldDistribution(yieldAmount, startTime, endTime); } /// @notice Starts a new yield distribution period /// @dev Can only be called by the distribution contract /// @param yieldAmount The amount of yield to distribute /// @param startTime The start time of the new yield period /// @param endTime The end time of the new yield period function _startYieldDistribution(uint256 yieldAmount, uint256 startTime, uint256 endTime) internal override { YieldDataStorage storage $ = _getYieldDataStorage(); IERC20 _asset = IERC20(asset()); if (yieldAmount == 0) { revert ZeroYieldAmount(); } if (startTime < block.timestamp) { revert StartTimeNotInFuture(); } if (endTime <= startTime) { revert EndTimeNotAfterStartTime(); } if (startTime < $.periodFinish) { revert StartTimeBeforePeriodFinish(); } if (block.timestamp < $.periodFinish) { revert CurrentTimeBeforePeriodFinish(); } _updateYield(); uint256 periodDuration = endTime - startTime; uint256 newYieldRate = Math.mulDiv(yieldAmount, YIELD_PRECISION, periodDuration, Math.Rounding.Floor); if (_asset.balanceOf(address(this)) < $.totalDeposits + yieldAmount) { revert InsufficientAssetsForYield(); } $.yieldRate = newYieldRate; $.periodStart = startTime; $.periodFinish = endTime; $.lastUpdateTime = startTime; $.isActive = true; } /// @notice Updates the withdrawal fee /// @dev Can only be called by addresses with WITHDRAW_FEE_UPDATER_ROLE /// @param newWithdrawFeeBps The new withdrawal fee in basis points function updateWithdrawFee(uint256 newWithdrawFeeBps) external { UsualXStorageV0 storage $ = _usualXStorageV0(); $.registryAccess.onlyMatchingRole(WITHDRAW_FEE_UPDATER_ROLE); if (newWithdrawFeeBps > MAX_25_PERCENT_WITHDRAW_FEE) { revert AmountTooBig(); } $.withdrawFeeBps = newWithdrawFeeBps; emit WithdrawFeeUpdated(newWithdrawFeeBps); } /// @notice Returns the withdrawal fee in basis points /// @return The withdrawal fee in basis points function withdrawFeeBps() public view returns (uint256) { UsualXStorageV0 storage $ = _usualXStorageV0(); return $.withdrawFeeBps; } /** * @dev Deposits assets with permit from msg.sender and mints shares to receiver. * @param assets The amount of assets to deposit. * @param receiver The address receiving the shares. * @param deadline The deadline for the permit. * @param v The recovery id for the permit. * @param r The r value for the permit. * @param s The s value for the permit. * @return shares The amount of shares minted. */ function depositWithPermit( uint256 assets, address receiver, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external nonReentrant whenNotPaused returns (uint256 shares) { try IERC20Permit(asset()).permit(msg.sender, address(this), assets, deadline, v, r, s) {} // solhint-disable-line no-empty-blocks catch {} // solhint-disable-line no-empty-blocks return deposit(assets, receiver); } /** * @dev See {IERC4626-deposit}. */ function deposit(uint256 assets, address receiver) public override whenNotPaused returns (uint256 shares) { return super.deposit(assets, receiver); } /** * @dev See {IERC4626-mint}. */ function mint(uint256 shares, address receiver) public override whenNotPaused returns (uint256) { return super.mint(shares, receiver); } /** * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver, * with the withdrawal fee taken in addition. * @param assets The amount of assets to withdraw. * @param receiver The address receiving the assets. * @param owner The address owning the shares. * @return shares The amount of shares burned. */ function withdraw(uint256 assets, address receiver, address owner) public override nonReentrant whenNotPaused returns (uint256 shares) { UsualXStorageV0 storage $ = _usualXStorageV0(); YieldDataStorage storage yieldStorage = _getYieldDataStorage(); // Check withdrawal limit uint256 maxAssets = maxWithdraw(owner); // maxAssets take into account the fee if (assets > maxAssets) { revert ERC4626ExceededMaxWithdraw(owner, assets, maxAssets); } shares = previewWithdraw(assets); // we need to add the fee on the assets to know exactly the shares to burn // assets is 100% - fee% of the total assets uint256 fee = Math.mulDiv( assets, $.withdrawFeeBps, BASIS_POINT_BASE - $.withdrawFeeBps, Math.Rounding.Ceil ); // Perform withdrawal (exact assets to receiver) super._withdraw(_msgSender(), receiver, owner, assets, shares); // take the fee yieldStorage.totalDeposits -= fee; } /** * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver, * with the withdrawal fee already accounted for in the asset amount. * @param shares The amount of shares to redeem. * @param receiver The address receiving the assets. * @param owner The address owning the shares. * @return assets The amount of assets withdrawn. */ function redeem(uint256 shares, address receiver, address owner) public override nonReentrant whenNotPaused returns (uint256 assets) { YieldDataStorage storage yieldStorage = _getYieldDataStorage(); // Check redemption limit uint256 maxShares = maxRedeem(owner); if (shares > maxShares) { revert ERC4626ExceededMaxRedeem(owner, shares, maxShares); } // Calculate assets after fee assets = previewRedeem(shares); uint256 assetsWithoutFee = convertToAssets(shares); uint256 fee = assetsWithoutFee - assets; // Perform redemption super._withdraw(_msgSender(), receiver, owner, assets, shares); // take the fee yieldStorage.totalDeposits -= fee; } /** * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block, * given current on-chain conditions. * * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw * call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if * called * in the same transaction. * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though * the withdrawal would be accepted, regardless if the user has enough shares, etc. * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees. * - MUST NOT revert. */ function previewWithdraw(uint256 assets) public view override returns (uint256 shares) { UsualXStorageV0 storage $ = _usualXStorageV0(); // Calculate the fee based on the equivalent assets of these shares uint256 fee = Math.mulDiv( assets, $.withdrawFeeBps, BASIS_POINT_BASE - $.withdrawFeeBps, Math.Rounding.Ceil ); // Calculate total assets needed, including fee uint256 assetsWithFee = assets + fee; // Convert the total assets (including fee) to shares shares = _convertToShares(assetsWithFee, Math.Rounding.Ceil); } /** * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the * Vault, through a withdraw call. * * - MUST return a limited value if owner is subject to some withdrawal limit or timelock. * - MUST NOT revert. */ function maxWithdraw(address owner) public view override returns (uint256) { return previewRedeem(balanceOf(owner)); } /** * @dev Allows an on-chain or off-chain user to simulate the effects of their redemption at the current block, * given current on-chain conditions. * * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call * in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the * same transaction. * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the * redemption would be accepted, regardless if the user has enough shares, etc. * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by redeeming. */ function previewRedeem(uint256 shares) public view override returns (uint256 assets) { UsualXStorageV0 storage $ = _usualXStorageV0(); // Calculate the raw amount of assets for the given shares uint256 assetsWithFee = convertToAssets(shares); // Calculates the fee part of an amount `assets` that already includes fees. uint256 fee = Math.mulDiv(assetsWithFee, $.withdrawFeeBps, BASIS_POINT_BASE, Math.Rounding.Ceil); assets = assetsWithFee - fee; } /// @notice Returns the current yield rate /// @return The yield rate function getYieldRate() external view returns (uint256) { YieldDataStorage storage $ = _getYieldDataStorage(); return $.yieldRate; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; import {IERC20Permit} from "../extensions/IERC20Permit.sol"; import {Address} from "../../../utils/Address.sol"; /** * @title SafeERC20 * @dev Wrappers around ERC20 operations that throw on failure (when the token * contract returns false). Tokens that return no value (and instead revert or * throw on failure) are also supported, non-reverting calls are assumed to be * successful. * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, * which allows you to call the safe operations as `token.safeTransfer(...)`, etc. */ library SafeERC20 { using Address for address; /** * @dev An operation with an ERC20 token failed. */ error SafeERC20FailedOperation(address token); /** * @dev Indicates a failed `decreaseAllowance` request. */ error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease); /** * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeTransfer(IERC20 token, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeCall(token.transfer, (to, value))); } /** * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful. */ function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeCall(token.transferFrom, (from, to, value))); } /** * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal { uint256 oldAllowance = token.allowance(address(this), spender); forceApprove(token, spender, oldAllowance + value); } /** * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no * value, non-reverting calls are assumed to be successful. */ function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal { unchecked { uint256 currentAllowance = token.allowance(address(this), spender); if (currentAllowance < requestedDecrease) { revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease); } forceApprove(token, spender, currentAllowance - requestedDecrease); } } /** * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval * to be set to zero before setting it to a non-zero value, such as USDT. */ function forceApprove(IERC20 token, address spender, uint256 value) internal { bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value)); if (!_callOptionalReturnBool(token, approvalCall)) { _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0))); _callOptionalReturn(token, approvalCall); } } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). */ function _callOptionalReturn(IERC20 token, bytes memory data) private { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that // the target address contains contract code and also asserts for success in the low-level call. bytes memory returndata = address(token).functionCall(data); if (returndata.length != 0 && !abi.decode(returndata, (bool))) { revert SafeERC20FailedOperation(address(token)); } } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). * * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead. */ function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false // and not revert is the subcall reverts. (bool success, bytes memory returndata) = address(token).call(data); return success && (returndata.length == 0 || abi.decode(returndata, (bool))) && address(token).code.length > 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/ERC4626.sol) pragma solidity ^0.8.20; import {IERC20, IERC20Metadata, ERC20} from "../ERC20.sol"; import {SafeERC20} from "../utils/SafeERC20.sol"; import {IERC4626} from "../../../interfaces/IERC4626.sol"; import {Math} from "../../../utils/math/Math.sol"; /** * @dev Implementation of the ERC4626 "Tokenized Vault Standard" as defined in * https://eips.ethereum.org/EIPS/eip-4626[EIP-4626]. * * This extension allows the minting and burning of "shares" (represented using the ERC20 inheritance) in exchange for * underlying "assets" through standardized {deposit}, {mint}, {redeem} and {burn} workflows. This contract extends * the ERC20 standard. Any additional extensions included along it would affect the "shares" token represented by this * contract and not the "assets" token which is an independent contract. * * [CAUTION] * ==== * In empty (or nearly empty) ERC-4626 vaults, deposits are at high risk of being stolen through frontrunning * with a "donation" to the vault that inflates the price of a share. This is variously known as a donation or inflation * attack and is essentially a problem of slippage. Vault deployers can protect against this attack by making an initial * deposit of a non-trivial amount of the asset, such that price manipulation becomes infeasible. Withdrawals may * similarly be affected by slippage. Users can protect against this attack as well as unexpected slippage in general by * verifying the amount received is as expected, using a wrapper that performs these checks such as * https://github.com/fei-protocol/ERC4626#erc4626router-and-base[ERC4626Router]. * * Since v4.9, this implementation uses virtual assets and shares to mitigate that risk. The `_decimalsOffset()` * corresponds to an offset in the decimal representation between the underlying asset's decimals and the vault * decimals. This offset also determines the rate of virtual shares to virtual assets in the vault, which itself * determines the initial exchange rate. While not fully preventing the attack, analysis shows that the default offset * (0) makes it non-profitable, as a result of the value being captured by the virtual shares (out of the attacker's * donation) matching the attacker's expected gains. With a larger offset, the attack becomes orders of magnitude more * expensive than it is profitable. More details about the underlying math can be found * xref:erc4626.adoc#inflation-attack[here]. * * The drawback of this approach is that the virtual shares do capture (a very small) part of the value being accrued * to the vault. Also, if the vault experiences losses, the users try to exit the vault, the virtual shares and assets * will cause the first user to exit to experience reduced losses in detriment to the last users that will experience * bigger losses. Developers willing to revert back to the pre-v4.9 behavior just need to override the * `_convertToShares` and `_convertToAssets` functions. * * To learn more, check out our xref:ROOT:erc4626.adoc[ERC-4626 guide]. * ==== */ abstract contract ERC4626 is ERC20, IERC4626 { using Math for uint256; IERC20 private immutable _asset; uint8 private immutable _underlyingDecimals; /** * @dev Attempted to deposit more assets than the max amount for `receiver`. */ error ERC4626ExceededMaxDeposit(address receiver, uint256 assets, uint256 max); /** * @dev Attempted to mint more shares than the max amount for `receiver`. */ error ERC4626ExceededMaxMint(address receiver, uint256 shares, uint256 max); /** * @dev Attempted to withdraw more assets than the max amount for `receiver`. */ error ERC4626ExceededMaxWithdraw(address owner, uint256 assets, uint256 max); /** * @dev Attempted to redeem more shares than the max amount for `receiver`. */ error ERC4626ExceededMaxRedeem(address owner, uint256 shares, uint256 max); /** * @dev Set the underlying asset contract. This must be an ERC20-compatible contract (ERC20 or ERC777). */ constructor(IERC20 asset_) { (bool success, uint8 assetDecimals) = _tryGetAssetDecimals(asset_); _underlyingDecimals = success ? assetDecimals : 18; _asset = asset_; } /** * @dev Attempts to fetch the asset decimals. A return value of false indicates that the attempt failed in some way. */ function _tryGetAssetDecimals(IERC20 asset_) private view returns (bool, uint8) { (bool success, bytes memory encodedDecimals) = address(asset_).staticcall( abi.encodeCall(IERC20Metadata.decimals, ()) ); if (success && encodedDecimals.length >= 32) { uint256 returnedDecimals = abi.decode(encodedDecimals, (uint256)); if (returnedDecimals <= type(uint8).max) { return (true, uint8(returnedDecimals)); } } return (false, 0); } /** * @dev Decimals are computed by adding the decimal offset on top of the underlying asset's decimals. This * "original" value is cached during construction of the vault contract. If this read operation fails (e.g., the * asset has not been created yet), a default of 18 is used to represent the underlying asset's decimals. * * See {IERC20Metadata-decimals}. */ function decimals() public view virtual override(IERC20Metadata, ERC20) returns (uint8) { return _underlyingDecimals + _decimalsOffset(); } /** @dev See {IERC4626-asset}. */ function asset() public view virtual returns (address) { return address(_asset); } /** @dev See {IERC4626-totalAssets}. */ function totalAssets() public view virtual returns (uint256) { return _asset.balanceOf(address(this)); } /** @dev See {IERC4626-convertToShares}. */ function convertToShares(uint256 assets) public view virtual returns (uint256) { return _convertToShares(assets, Math.Rounding.Floor); } /** @dev See {IERC4626-convertToAssets}. */ function convertToAssets(uint256 shares) public view virtual returns (uint256) { return _convertToAssets(shares, Math.Rounding.Floor); } /** @dev See {IERC4626-maxDeposit}. */ function maxDeposit(address) public view virtual returns (uint256) { return type(uint256).max; } /** @dev See {IERC4626-maxMint}. */ function maxMint(address) public view virtual returns (uint256) { return type(uint256).max; } /** @dev See {IERC4626-maxWithdraw}. */ function maxWithdraw(address owner) public view virtual returns (uint256) { return _convertToAssets(balanceOf(owner), Math.Rounding.Floor); } /** @dev See {IERC4626-maxRedeem}. */ function maxRedeem(address owner) public view virtual returns (uint256) { return balanceOf(owner); } /** @dev See {IERC4626-previewDeposit}. */ function previewDeposit(uint256 assets) public view virtual returns (uint256) { return _convertToShares(assets, Math.Rounding.Floor); } /** @dev See {IERC4626-previewMint}. */ function previewMint(uint256 shares) public view virtual returns (uint256) { return _convertToAssets(shares, Math.Rounding.Ceil); } /** @dev See {IERC4626-previewWithdraw}. */ function previewWithdraw(uint256 assets) public view virtual returns (uint256) { return _convertToShares(assets, Math.Rounding.Ceil); } /** @dev See {IERC4626-previewRedeem}. */ function previewRedeem(uint256 shares) public view virtual returns (uint256) { return _convertToAssets(shares, Math.Rounding.Floor); } /** @dev See {IERC4626-deposit}. */ function deposit(uint256 assets, address receiver) public virtual returns (uint256) { uint256 maxAssets = maxDeposit(receiver); if (assets > maxAssets) { revert ERC4626ExceededMaxDeposit(receiver, assets, maxAssets); } uint256 shares = previewDeposit(assets); _deposit(_msgSender(), receiver, assets, shares); return shares; } /** @dev See {IERC4626-mint}. * * As opposed to {deposit}, minting is allowed even if the vault is in a state where the price of a share is zero. * In this case, the shares will be minted without requiring any assets to be deposited. */ function mint(uint256 shares, address receiver) public virtual returns (uint256) { uint256 maxShares = maxMint(receiver); if (shares > maxShares) { revert ERC4626ExceededMaxMint(receiver, shares, maxShares); } uint256 assets = previewMint(shares); _deposit(_msgSender(), receiver, assets, shares); return assets; } /** @dev See {IERC4626-withdraw}. */ function withdraw(uint256 assets, address receiver, address owner) public virtual returns (uint256) { uint256 maxAssets = maxWithdraw(owner); if (assets > maxAssets) { revert ERC4626ExceededMaxWithdraw(owner, assets, maxAssets); } uint256 shares = previewWithdraw(assets); _withdraw(_msgSender(), receiver, owner, assets, shares); return shares; } /** @dev See {IERC4626-redeem}. */ function redeem(uint256 shares, address receiver, address owner) public virtual returns (uint256) { uint256 maxShares = maxRedeem(owner); if (shares > maxShares) { revert ERC4626ExceededMaxRedeem(owner, shares, maxShares); } uint256 assets = previewRedeem(shares); _withdraw(_msgSender(), receiver, owner, assets, shares); return assets; } /** * @dev Internal conversion function (from assets to shares) with support for rounding direction. */ function _convertToShares(uint256 assets, Math.Rounding rounding) internal view virtual returns (uint256) { return assets.mulDiv(totalSupply() + 10 ** _decimalsOffset(), totalAssets() + 1, rounding); } /** * @dev Internal conversion function (from shares to assets) with support for rounding direction. */ function _convertToAssets(uint256 shares, Math.Rounding rounding) internal view virtual returns (uint256) { return shares.mulDiv(totalAssets() + 1, totalSupply() + 10 ** _decimalsOffset(), rounding); } /** * @dev Deposit/mint common workflow. */ function _deposit(address caller, address receiver, uint256 assets, uint256 shares) internal virtual { // If _asset is ERC777, `transferFrom` can trigger a reentrancy BEFORE the transfer happens through the // `tokensToSend` hook. On the other hand, the `tokenReceived` hook, that is triggered after the transfer, // calls the vault, which is assumed not malicious. // // Conclusion: we need to do the transfer before we mint so that any reentrancy would happen before the // assets are transferred and before the shares are minted, which is a valid state. // slither-disable-next-line reentrancy-no-eth SafeERC20.safeTransferFrom(_asset, caller, address(this), assets); _mint(receiver, shares); emit Deposit(caller, receiver, assets, shares); } /** * @dev Withdraw/redeem common workflow. */ function _withdraw( address caller, address receiver, address owner, uint256 assets, uint256 shares ) internal virtual { if (caller != owner) { _spendAllowance(owner, caller, shares); } // If _asset is ERC777, `transfer` can trigger a reentrancy AFTER the transfer happens through the // `tokensReceived` hook. On the other hand, the `tokensToSend` hook, that is triggered before the transfer, // calls the vault, which is assumed not malicious. // // Conclusion: we need to do the transfer after the burn so that any reentrancy would happen after the // shares are burned and after the assets are transferred, which is a valid state. _burn(owner, shares); SafeERC20.safeTransfer(_asset, receiver, assets); emit Withdraw(caller, receiver, owner, assets, shares); } function _decimalsOffset() internal view virtual returns (uint8) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Permit.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. * * ==== Security Considerations * * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be * considered as an intention to spend the allowance in any specific way. The second is that because permits have * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be * generally recommended is: * * ```solidity * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public { * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {} * doThing(..., value); * } * * function doThing(..., uint256 value) public { * token.safeTransferFrom(msg.sender, address(this), value); * ... * } * ``` * * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also * {SafeERC20-safeTransferFrom}). * * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so * contracts should have entry points that don't rely on permit. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. * * CAUTION: See Security Considerations above. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {ContextUpgradeable} from "../../utils/ContextUpgradeable.sol"; import {IERC20Errors} from "@openzeppelin/contracts/interfaces/draft-IERC6093.sol"; import {Initializable} from "../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the {IERC20} interface. * * This implementation is agnostic to the way tokens are created. This means * that a supply mechanism has to be added in a derived contract using {_mint}. * * TIP: For a detailed writeup see our guide * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How * to implement supply mechanisms]. * * The default value of {decimals} is 18. To change this, you should override * this function so it returns a different value. * * We have followed general OpenZeppelin Contracts guidelines: functions revert * instead returning `false` on failure. This behavior is nonetheless * conventional and does not conflict with the expectations of 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. */ abstract contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20, IERC20Metadata, IERC20Errors { /// @custom:storage-location erc7201:openzeppelin.storage.ERC20 struct ERC20Storage { mapping(address account => uint256) _balances; mapping(address account => mapping(address spender => uint256)) _allowances; uint256 _totalSupply; string _name; string _symbol; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC20")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant ERC20StorageLocation = 0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00; function _getERC20Storage() private pure returns (ERC20Storage storage $) { assembly { $.slot := ERC20StorageLocation } } /** * @dev Sets the values for {name} and {symbol}. * * All two of these values are immutable: they can only be set once during * construction. */ function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing { __ERC20_init_unchained(name_, symbol_); } function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing { ERC20Storage storage $ = _getERC20Storage(); $._name = name_; $._symbol = symbol_; } /** * @dev Returns the name of the token. */ function name() public view virtual returns (string memory) { ERC20Storage storage $ = _getERC20Storage(); return $._name; } /** * @dev Returns the symbol of the token, usually a shorter version of the * name. */ function symbol() public view virtual returns (string memory) { ERC20Storage storage $ = _getERC20Storage(); return $._symbol; } /** * @dev Returns the number of decimals used to get its user representation. * For example, if `decimals` equals `2`, a balance of `505` tokens should * be displayed to a user as `5.05` (`505 / 10 ** 2`). * * Tokens usually opt for a value of 18, imitating the relationship between * Ether and Wei. This is the default value returned by this function, unless * it's overridden. * * NOTE: This information is only used for _display_ purposes: it in * no way affects any of the arithmetic of the contract, including * {IERC20-balanceOf} and {IERC20-transfer}. */ function decimals() public view virtual returns (uint8) { return 18; } /** * @dev See {IERC20-totalSupply}. */ function totalSupply() public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._totalSupply; } /** * @dev See {IERC20-balanceOf}. */ function balanceOf(address account) public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._balances[account]; } /** * @dev See {IERC20-transfer}. * * Requirements: * * - `to` cannot be the zero address. * - the caller must have a balance of at least `value`. */ function transfer(address to, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _transfer(owner, to, value); return true; } /** * @dev See {IERC20-allowance}. */ function allowance(address owner, address spender) public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._allowances[owner][spender]; } /** * @dev See {IERC20-approve}. * * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on * `transferFrom`. This is semantically equivalent to an infinite approval. * * Requirements: * * - `spender` cannot be the zero address. */ function approve(address spender, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _approve(owner, spender, value); return true; } /** * @dev See {IERC20-transferFrom}. * * 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 `value`. * - the caller must have allowance for ``from``'s tokens of at least * `value`. */ function transferFrom(address from, address to, uint256 value) public virtual returns (bool) { address spender = _msgSender(); _spendAllowance(from, spender, value); _transfer(from, to, value); return true; } /** * @dev Moves a `value` amount of tokens from `from` to `to`. * * This internal function is equivalent to {transfer}, and can be used to * e.g. implement automatic token fees, slashing mechanisms, etc. * * Emits a {Transfer} event. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _transfer(address from, address to, uint256 value) internal { if (from == address(0)) { revert ERC20InvalidSender(address(0)); } if (to == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(from, to, value); } /** * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from` * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding * this function. * * Emits a {Transfer} event. */ function _update(address from, address to, uint256 value) internal virtual { ERC20Storage storage $ = _getERC20Storage(); if (from == address(0)) { // Overflow check required: The rest of the code assumes that totalSupply never overflows $._totalSupply += value; } else { uint256 fromBalance = $._balances[from]; if (fromBalance < value) { revert ERC20InsufficientBalance(from, fromBalance, value); } unchecked { // Overflow not possible: value <= fromBalance <= totalSupply. $._balances[from] = fromBalance - value; } } if (to == address(0)) { unchecked { // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply. $._totalSupply -= value; } } else { unchecked { // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256. $._balances[to] += value; } } emit Transfer(from, to, value); } /** * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0). * Relies on the `_update` mechanism * * Emits a {Transfer} event with `from` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _mint(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(address(0), account, value); } /** * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply. * Relies on the `_update` mechanism. * * Emits a {Transfer} event with `to` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead */ function _burn(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidSender(address(0)); } _update(account, address(0), value); } /** * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens. * * This internal function is equivalent to `approve`, and can be used to * e.g. set automatic allowances for certain subsystems, etc. * * Emits an {Approval} event. * * Requirements: * * - `owner` cannot be the zero address. * - `spender` cannot be the zero address. * * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument. */ function _approve(address owner, address spender, uint256 value) internal { _approve(owner, spender, value, true); } /** * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event. * * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any * `Approval` event during `transferFrom` operations. * * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to * true using the following override: * ``` * function _approve(address owner, address spender, uint256 value, bool) internal virtual override { * super._approve(owner, spender, value, true); * } * ``` * * Requirements are the same as {_approve}. */ function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual { ERC20Storage storage $ = _getERC20Storage(); if (owner == address(0)) { revert ERC20InvalidApprover(address(0)); } if (spender == address(0)) { revert ERC20InvalidSpender(address(0)); } $._allowances[owner][spender] = value; if (emitEvent) { emit Approval(owner, spender, value); } } /** * @dev Updates `owner` s allowance for `spender` based on spent `value`. * * Does not update the allowance value in case of infinite allowance. * Revert if not enough allowance is available. * * Does not emit an {Approval} event. */ function _spendAllowance(address owner, address spender, uint256 value) internal virtual { uint256 currentAllowance = allowance(owner, spender); if (currentAllowance != type(uint256).max) { if (currentAllowance < value) { revert ERC20InsufficientAllowance(spender, currentAllowance, value); } unchecked { _approve(owner, spender, currentAllowance - value, false); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Pausable.sol) pragma solidity ^0.8.20; import {ContextUpgradeable} from "../utils/ContextUpgradeable.sol"; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module which allows children to implement an emergency stop * mechanism that can be triggered by an authorized account. * * This module is used through inheritance. It will make available the * modifiers `whenNotPaused` and `whenPaused`, which can be applied to * the functions of your contract. Note that they will not be pausable by * simply including this module, only once the modifiers are put in place. */ abstract contract PausableUpgradeable is Initializable, ContextUpgradeable { /// @custom:storage-location erc7201:openzeppelin.storage.Pausable struct PausableStorage { bool _paused; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Pausable")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant PausableStorageLocation = 0xcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f03300; function _getPausableStorage() private pure returns (PausableStorage storage $) { assembly { $.slot := PausableStorageLocation } } /** * @dev Emitted when the pause is triggered by `account`. */ event Paused(address account); /** * @dev Emitted when the pause is lifted by `account`. */ event Unpaused(address account); /** * @dev The operation failed because the contract is paused. */ error EnforcedPause(); /** * @dev The operation failed because the contract is not paused. */ error ExpectedPause(); /** * @dev Initializes the contract in unpaused state. */ function __Pausable_init() internal onlyInitializing { __Pausable_init_unchained(); } function __Pausable_init_unchained() internal onlyInitializing { PausableStorage storage $ = _getPausableStorage(); $._paused = false; } /** * @dev Modifier to make a function callable only when the contract is not paused. * * Requirements: * * - The contract must not be paused. */ modifier whenNotPaused() { _requireNotPaused(); _; } /** * @dev Modifier to make a function callable only when the contract is paused. * * Requirements: * * - The contract must be paused. */ modifier whenPaused() { _requirePaused(); _; } /** * @dev Returns true if the contract is paused, and false otherwise. */ function paused() public view virtual returns (bool) { PausableStorage storage $ = _getPausableStorage(); return $._paused; } /** * @dev Throws if the contract is paused. */ function _requireNotPaused() internal view virtual { if (paused()) { revert EnforcedPause(); } } /** * @dev Throws if the contract is not paused. */ function _requirePaused() internal view virtual { if (!paused()) { revert ExpectedPause(); } } /** * @dev Triggers stopped state. * * Requirements: * * - The contract must not be paused. */ function _pause() internal virtual whenNotPaused { PausableStorage storage $ = _getPausableStorage(); $._paused = true; emit Paused(_msgSender()); } /** * @dev Returns to normal state. * * Requirements: * * - The contract must be paused. */ function _unpause() internal virtual whenPaused { PausableStorage storage $ = _getPausableStorage(); $._paused = false; emit Unpaused(_msgSender()); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/ReentrancyGuard.sol) pragma solidity ^0.8.20; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuardUpgradeable is Initializable { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant NOT_ENTERED = 1; uint256 private constant ENTERED = 2; /// @custom:storage-location erc7201:openzeppelin.storage.ReentrancyGuard struct ReentrancyGuardStorage { uint256 _status; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ReentrancyGuard")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant ReentrancyGuardStorageLocation = 0x9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00; function _getReentrancyGuardStorage() private pure returns (ReentrancyGuardStorage storage $) { assembly { $.slot := ReentrancyGuardStorageLocation } } /** * @dev Unauthorized reentrant call. */ error ReentrancyGuardReentrantCall(); function __ReentrancyGuard_init() internal onlyInitializing { __ReentrancyGuard_init_unchained(); } function __ReentrancyGuard_init_unchained() internal onlyInitializing { ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage(); $._status = NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage(); // On the first call to nonReentrant, _status will be NOT_ENTERED if ($._status == ENTERED) { revert ReentrancyGuardReentrantCall(); } // Any calls to nonReentrant after this point will fail $._status = ENTERED; } function _nonReentrantAfter() private { ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage(); // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) $._status = NOT_ENTERED; } /** * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a * `nonReentrant` function in the call stack. */ function _reentrancyGuardEntered() internal view returns (bool) { ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage(); return $._status == ENTERED; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol) pragma solidity ^0.8.20; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { /** * @dev Muldiv operation overflow. */ error MathOverflowedMulDiv(); enum Rounding { Floor, // Toward negative infinity Ceil, // Toward positive infinity Trunc, // Toward zero Expand // Away from zero } /** * @dev Returns the addition of two unsigned integers, with an overflow flag. */ function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { uint256 c = a + b; if (c < a) return (false, 0); return (true, c); } } /** * @dev Returns the subtraction of two unsigned integers, with an overflow flag. */ function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b > a) return (false, 0); return (true, a - b); } } /** * @dev Returns the multiplication of two unsigned integers, with an overflow flag. */ function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { // Gas optimization: this is cheaper than requiring 'a' not being zero, but the // benefit is lost if 'b' is also tested. // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522 if (a == 0) return (true, 0); uint256 c = a * b; if (c / a != b) return (false, 0); return (true, c); } } /** * @dev Returns the division of two unsigned integers, with a division by zero flag. */ function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a / b); } } /** * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag. */ function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a % b); } } /** * @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 towards infinity instead * of rounding towards zero. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { if (b == 0) { // Guarantee the same behavior as in a regular Solidity division. return a / b; } // (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 = x * y; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { // Solidity will revert if denominator == 0, unlike the div opcode on its own. // The surrounding unchecked block does not change this fact. // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic. return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. if (denominator <= prod1) { revert MathOverflowedMulDiv(); } /////////////////////////////////////////////// // 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. uint256 twos = denominator & (0 - denominator); 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 (unsignedRoundsUp(rounding) && 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 * towards zero. * * 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 + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2 of a positive value rounded towards zero. * 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 + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10 of a positive value rounded towards zero. * 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 + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0); } } /** * @dev Return the log in base 256 of a positive value rounded towards zero. * 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 256, 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 + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0); } } /** * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers. */ function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) { return uint8(rounding) % 2 == 1; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/cryptography/EIP712.sol) pragma solidity ^0.8.20; import {MessageHashUtils} from "@openzeppelin/contracts/utils/cryptography/MessageHashUtils.sol"; import {IERC5267} from "@openzeppelin/contracts/interfaces/IERC5267.sol"; import {Initializable} from "../../proxy/utils/Initializable.sol"; /** * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data. * * The encoding scheme specified in the EIP requires a domain separator and a hash of the typed structured data, whose * encoding is very generic and therefore its implementation in Solidity is not feasible, thus this contract * does not implement the encoding itself. Protocols need to implement the type-specific encoding they need in order to * produce the hash of their typed data using a combination of `abi.encode` and `keccak256`. * * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA * ({_hashTypedDataV4}). * * The implementation of the domain separator was designed to be as efficient as possible while still properly updating * the chain id to protect against replay attacks on an eventual fork of the chain. * * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask]. * * NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain * separator of the implementation contract. This will cause the {_domainSeparatorV4} function to always rebuild the * separator from the immutable values, which is cheaper than accessing a cached version in cold storage. */ abstract contract EIP712Upgradeable is Initializable, IERC5267 { bytes32 private constant TYPE_HASH = keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"); /// @custom:storage-location erc7201:openzeppelin.storage.EIP712 struct EIP712Storage { /// @custom:oz-renamed-from _HASHED_NAME bytes32 _hashedName; /// @custom:oz-renamed-from _HASHED_VERSION bytes32 _hashedVersion; string _name; string _version; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.EIP712")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant EIP712StorageLocation = 0xa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100; function _getEIP712Storage() private pure returns (EIP712Storage storage $) { assembly { $.slot := EIP712StorageLocation } } /** * @dev Initializes the domain separator and parameter caches. * * The meaning of `name` and `version` is specified in * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]: * * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol. * - `version`: the current major version of the signing domain. * * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart * contract upgrade]. */ function __EIP712_init(string memory name, string memory version) internal onlyInitializing { __EIP712_init_unchained(name, version); } function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing { EIP712Storage storage $ = _getEIP712Storage(); $._name = name; $._version = version; // Reset prior values in storage if upgrading $._hashedName = 0; $._hashedVersion = 0; } /** * @dev Returns the domain separator for the current chain. */ function _domainSeparatorV4() internal view returns (bytes32) { return _buildDomainSeparator(); } function _buildDomainSeparator() private view returns (bytes32) { return keccak256(abi.encode(TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash(), block.chainid, address(this))); } /** * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this * function returns the hash of the fully encoded EIP712 message for this domain. * * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example: * * ```solidity * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode( * keccak256("Mail(address to,string contents)"), * mailTo, * keccak256(bytes(mailContents)) * ))); * address signer = ECDSA.recover(digest, signature); * ``` */ function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) { return MessageHashUtils.toTypedDataHash(_domainSeparatorV4(), structHash); } /** * @dev See {IERC-5267}. */ function eip712Domain() public view virtual returns ( bytes1 fields, string memory name, string memory version, uint256 chainId, address verifyingContract, bytes32 salt, uint256[] memory extensions ) { EIP712Storage storage $ = _getEIP712Storage(); // If the hashed name and version in storage are non-zero, the contract hasn't been properly initialized // and the EIP712 domain is not reliable, as it will be missing name and version. require($._hashedName == 0 && $._hashedVersion == 0, "EIP712: Uninitialized"); return ( hex"0f", // 01111 _EIP712Name(), _EIP712Version(), block.chainid, address(this), bytes32(0), new uint256[](0) ); } /** * @dev The name parameter for the EIP712 domain. * * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs * are a concern. */ function _EIP712Name() internal view virtual returns (string memory) { EIP712Storage storage $ = _getEIP712Storage(); return $._name; } /** * @dev The version parameter for the EIP712 domain. * * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs * are a concern. */ function _EIP712Version() internal view virtual returns (string memory) { EIP712Storage storage $ = _getEIP712Storage(); return $._version; } /** * @dev The hash of the name parameter for the EIP712 domain. * * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Name` instead. */ function _EIP712NameHash() internal view returns (bytes32) { EIP712Storage storage $ = _getEIP712Storage(); string memory name = _EIP712Name(); if (bytes(name).length > 0) { return keccak256(bytes(name)); } else { // If the name is empty, the contract may have been upgraded without initializing the new storage. // We return the name hash in storage if non-zero, otherwise we assume the name is empty by design. bytes32 hashedName = $._hashedName; if (hashedName != 0) { return hashedName; } else { return keccak256(""); } } } /** * @dev The hash of the version parameter for the EIP712 domain. * * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Version` instead. */ function _EIP712VersionHash() internal view returns (bytes32) { EIP712Storage storage $ = _getEIP712Storage(); string memory version = _EIP712Version(); if (bytes(version).length > 0) { return keccak256(bytes(version)); } else { // If the version is empty, the contract may have been upgraded without initializing the new storage. // We return the version hash in storage if non-zero, otherwise we assume the version is empty by design. bytes32 hashedVersion = $._hashedVersion; if (hashedVersion != 0) { return hashedVersion; } else { return keccak256(""); } } } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; import {IAccessControlDefaultAdminRules} from "openzeppelin-contracts/access/extensions/IAccessControlDefaultAdminRules.sol"; // solhint-disable-next-line no-empty-blocks interface IRegistryAccess is IAccessControlDefaultAdminRules {}
// SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; interface IRegistryContract { function setContract(bytes32 name, address contractAddress) external; function getContract(bytes32 name) external view returns (address); }
// SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; import {IERC20Metadata} from "openzeppelin-contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {Math} from "openzeppelin-contracts/utils/math/Math.sol"; import {SCALAR_ONE} from "src/constants.sol"; /// @title Normalize decimals between tokens library Normalize { /// @notice Normalize token amount to target decimals /// @notice i.e 100 USDC with 6 decimals to 100e18 USDC with 18 decimals /// @param tokenAmount The token amount /// @param tokenDecimals The token decimals /// @param targetDecimals The target decimals function tokenAmountToDecimals(uint256 tokenAmount, uint8 tokenDecimals, uint8 targetDecimals) internal pure returns (uint256) { if (tokenDecimals < targetDecimals) { return tokenAmount * (10 ** uint256(targetDecimals - tokenDecimals)); } else if (tokenDecimals > targetDecimals) { return tokenAmount / (10 ** uint256(tokenDecimals - targetDecimals)); } else { return tokenAmount; } } /// @notice Normalize token amount to 18 decimals /// @notice i.e 100 USDC with 6 decimals to 100e18 USDC with 18 decimals /// @param tokenAmount The token amount /// @param tokenDecimals The token decimals function tokenAmountToWad(uint256 tokenAmount, uint8 tokenDecimals) internal pure returns (uint256) { return tokenAmountToDecimals(tokenAmount, tokenDecimals, 18); } /// @notice Normalize token amount to wad /// @notice i.e 10e6 USYC with 6 decimals will result in wadAmount = 10e18 and tokenDecimals = 6 /// @param token The token address /// @param tokenAmount The token amount /// @return wadAmount The normalized token amount in wad /// @return tokenDecimals The token decimals function tokenAmountToWadWithTokenAddress(uint256 tokenAmount, address token) internal view returns (uint256, uint8) { uint8 tokenDecimals = uint8(IERC20Metadata(token).decimals()); uint256 wadAmount = tokenAmountToWad(tokenAmount, uint8(tokenDecimals)); return (wadAmount, tokenDecimals); } /// @notice Returns wad amount of token at wad price. /// @notice i.e 10e6 USYC with 6 decimals will be wadAmount = 10e18 /// @notice if wadPrice is 1e18 USD then 10e18 USD0 will be worth 10e18 USD /// @param wadAmount The wad amount (18 decimals) /// @param wadPrice The wad price (18 decimals) /// @return The normalized token amount for price function wadAmountByPrice(uint256 wadAmount, uint256 wadPrice) internal pure returns (uint256) { return Math.mulDiv(wadAmount, wadPrice, SCALAR_ONE, Math.Rounding.Floor); } /// @notice return how much token we can have for stable amount. /// @notice i.e 10 (10e18) USD0 with 18 decimals worth 2$ each (2e18) will return 5e6 USYC with 6 decimals /// @param wadStableAmount The wad stable token amount /// @param wadPrice The wad price with for the token in stable /// @param tokenDecimals The token decimals /// @return The token amount for price with token decimals function wadTokenAmountForPrice(uint256 wadStableAmount, uint256 wadPrice, uint8 tokenDecimals) internal pure returns (uint256) { return Math.mulDiv(wadStableAmount, 10 ** tokenDecimals, wadPrice, Math.Rounding.Floor); } /// @dev Converts a WAD amount to a different number of decimals. /// @param wadAmount The WAD amount to convert. /// @param targetDecimals The number of decimals to convert to. /// @return The converted amount with the target number of decimals. function wadAmountToDecimals(uint256 wadAmount, uint8 targetDecimals) internal pure returns (uint256) { return tokenAmountToDecimals(wadAmount, 18, targetDecimals); } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; import {IRegistryAccess} from "src/interfaces/registry/IRegistryAccess.sol"; import {NotAuthorized} from "src/errors.sol"; /// @title Check Access control library library CheckAccessControl { /// @dev Function to restrict to one access role. /// @param registryAccess The registry access contract. /// @param role The role being checked. function onlyMatchingRole(IRegistryAccess registryAccess, bytes32 role) internal view { if (!registryAccess.hasRole(role, msg.sender)) { revert NotAuthorized(); } } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.20; import {ERC4626Upgradeable} from "openzeppelin-contracts-upgradeable/token/ERC20/extensions/ERC4626Upgradeable.sol"; import {IERC20} from "openzeppelin-contracts/token/ERC20/extensions/ERC4626.sol"; import {Math} from "openzeppelin-contracts/utils/math/Math.sol"; import {YIELD_PRECISION} from "src/constants.sol"; /** * @title AbstractYieldBearingVault * @dev Abstract contract for a vault where shares appreciate in value due to yield accrual */ abstract contract YieldBearingVault is ERC4626Upgradeable { /// @custom:storage-location erc7201:YieldBearingVault.storage.v1 struct YieldDataStorage { /// @notice Total assets deposited through deposit, tracked separately from assets reserved for yield. It excludes fees uint256 totalDeposits; /// @notice Yield tokens accrued per second uint256 yieldRate; /// @notice Start timestamp of the current yield period uint256 periodStart; /// @notice End timestamp of the current yield period uint256 periodFinish; /// @notice Timestamp of the last yield update used to calculate the earned yield uint256 lastUpdateTime; /// @notice Indicates whether there's an active yield period bool isActive; } //keccak256(abi.encode(uint256(keccak256("YieldBearingVault.storage.v1")) - 1)) & ~bytes32(uint256(0xff)) // solhint-disable bytes32 private constant YieldDataStorageLocation = 0x9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc6547600; function _getYieldDataStorage() internal pure returns (YieldDataStorage storage $) { assembly { $.slot := YieldDataStorageLocation } } // solhint-enable /** * @dev Initializes the contract */ //solhint-disable-next-line function __YieldBearingVault_init( address _underlyingToken, string memory _name, string memory _symbol ) internal onlyInitializing { __ERC4626_init(IERC20(_underlyingToken)); __ERC20_init(_name, _symbol); __YieldBearingVault_init_unchained(); } /** * @dev Initializes the contract */ //solhint-disable-next-line function __YieldBearingVault_init_unchained() internal onlyInitializing { YieldDataStorage storage $ = _getYieldDataStorage(); $.totalDeposits = 0; } /** * @dev Calculates total assets available to holders in the vault, including accrued yield and excluding fees. * @return Total amount of assets, including yield */ function totalAssets() public view override returns (uint256) { YieldDataStorage storage $ = _getYieldDataStorage(); uint256 currentAssets = $.totalDeposits + _calculateEarnedYield(); return currentAssets; } /** * @dev Internal function to handle deposits, updates yield, then takes assets then mints then updates total deposits * @param caller Address initiating the deposit * @param receiver Address receiving the minted shares * @param assets Amount of assets being deposited * @param shares Amount of shares to mint */ function _deposit(address caller, address receiver, uint256 assets, uint256 shares) internal virtual override { YieldDataStorage storage $ = _getYieldDataStorage(); // we MUST call it before any vault interactions _updateYield(); super._deposit(caller, receiver, assets, shares); $.totalDeposits += assets; } /** * @dev Internal function to handle withdrawals, updates yield, then burns shares, then transfers assets, then updates total deposits * @param caller Address initiating the withdrawal * @param receiver Address receiving the assets * @param owner Address owning the shares * @param assets Amount of assets to withdraw * @param shares Amount of shares to burn */ function _withdraw( address caller, address receiver, address owner, uint256 assets, uint256 shares ) internal virtual override { YieldDataStorage storage $ = _getYieldDataStorage(); _updateYield(); //NOTE: must be called before totalDeposited is incremented to add earned yield to totalDeposited before it is decremented to avoid underflow $.totalDeposits -= assets; super._withdraw(caller, receiver, owner, assets, shares); } /** * @dev Calculates the amount of yield that has been earned since the last update * If yield period is not active returns 0 * If yield is active calculate the delta since the last update capped at period finish and multiply by the yieldRate * * @return Amount of earned yield since last update time */ function _calculateEarnedYield() internal view virtual returns (uint256) { YieldDataStorage storage $ = _getYieldDataStorage(); if (!$.isActive) return 0; if (block.timestamp <= $.lastUpdateTime) { return 0; } uint256 endTime = Math.min(block.timestamp, $.periodFinish); uint256 duration = endTime - $.lastUpdateTime; return Math.mulDiv(duration, $.yieldRate, YIELD_PRECISION, Math.Rounding.Floor); } /** * @dev Updates the yield state, by calculating yield earned and adding it to total totalDeposits * keeps track of last update time stamp and deactivates update if yield period if finished to save gas */ function _updateYield() internal virtual { YieldDataStorage storage $ = _getYieldDataStorage(); if (!$.isActive) return; uint256 newYield = _calculateEarnedYield(); $.totalDeposits += newYield; $.lastUpdateTime = Math.min(block.timestamp, $.periodFinish); // if we are at the end of the period, deactivate yield if ($.lastUpdateTime >= $.periodFinish) { $.isActive = false; } } /** * @dev Starts a new yield distribution period * @param yieldAmount Amount of yield to distribute over the next period * @param startTime Start time of the new yield period * @param endTime End time of the new yield period */ function _startYieldDistribution(uint256 yieldAmount, uint256 startTime, uint256 endTime) internal virtual; }
// SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; /* Roles */ bytes32 constant DEFAULT_ADMIN_ROLE = 0x00; bytes32 constant PAUSING_CONTRACTS_ROLE = keccak256("PAUSING_CONTRACTS_ROLE"); bytes32 constant EARLY_BOND_UNLOCK_ROLE = keccak256("EARLY_BOND_UNLOCK_ROLE"); bytes32 constant BLACKLIST_ROLE = keccak256("BLACKLIST_ROLE"); bytes32 constant WHITELIST_ROLE = keccak256("WHITELIST_ROLE"); bytes32 constant WITHDRAW_FEE_UPDATER_ROLE = keccak256("WITHDRAW_FEE_UPDATER_ROLE"); bytes32 constant FLOOR_PRICE_UPDATER_ROLE = keccak256("FLOOR_PRICE_UPDATER_ROLE"); bytes32 constant DAO_COLLATERAL = keccak256("DAO_COLLATERAL_CONTRACT"); bytes32 constant USUALSP = keccak256("USUALSP_CONTRACT"); bytes32 constant USD0_MINT = keccak256("USD0_MINT"); bytes32 constant USD0_BURN = keccak256("USD0_BURN"); bytes32 constant USD0PP_MINT = keccak256("USD0PP_MINT"); bytes32 constant USD0PP_BURN = keccak256("USD0PP_BURN"); bytes32 constant USUALS_BURN = keccak256("USUALS_BURN"); bytes32 constant USUAL_MINT = keccak256("USUAL_MINT"); bytes32 constant USUAL_BURN = keccak256("USUAL_BURN"); bytes32 constant INTENT_MATCHING_ROLE = keccak256("INTENT_MATCHING_ROLE"); bytes32 constant NONCE_THRESHOLD_SETTER_ROLE = keccak256("NONCE_THRESHOLD_SETTER_ROLE"); bytes32 constant PEG_MAINTAINER_ROLE = keccak256("PEG_MAINTAINER_ROLE"); bytes32 constant SWAPPER_ENGINE = keccak256("SWAPPER_ENGINE"); bytes32 constant INTENT_TYPE_HASH = keccak256( "SwapIntent(address recipient,address rwaToken,uint256 amountInTokenDecimals,uint256 nonce,uint256 deadline)" ); bytes32 constant DISTRIBUTION_ALLOCATOR_ROLE = keccak256("DISTRIBUTION_ALLOCATOR_ROLE"); bytes32 constant DISTRIBUTION_OPERATOR_ROLE = keccak256("DISTRIBUTION_OPERATOR_ROLE"); bytes32 constant DISTRIBUTION_CHALLENGER_ROLE = keccak256("DISTRIBUTION_CHALLENGER_ROLE"); /* Airdrop Roles */ bytes32 constant AIRDROP_OPERATOR_ROLE = keccak256("AIRDROP_OPERATOR_ROLE"); bytes32 constant AIRDROP_PENALTY_OPERATOR_ROLE = keccak256("AIRDROP_PENALTY_OPERATOR_ROLE"); bytes32 constant USUALSP_OPERATOR_ROLE = keccak256("USUALSP_OPERATOR_ROLE"); /* Contracts */ bytes32 constant CONTRACT_REGISTRY_ACCESS = keccak256("CONTRACT_REGISTRY_ACCESS"); bytes32 constant CONTRACT_DAO_COLLATERAL = keccak256("CONTRACT_DAO_COLLATERAL"); bytes32 constant CONTRACT_USD0PP = keccak256("CONTRACT_USD0PP"); bytes32 constant CONTRACT_USUALS = keccak256("CONTRACT_USUALS"); bytes32 constant CONTRACT_USUALSP = keccak256("CONTRACT_USUALSP"); bytes32 constant CONTRACT_TOKEN_MAPPING = keccak256("CONTRACT_TOKEN_MAPPING"); bytes32 constant CONTRACT_ORACLE = keccak256("CONTRACT_ORACLE"); bytes32 constant CONTRACT_ORACLE_USUAL = keccak256("CONTRACT_ORACLE_USUAL"); bytes32 constant CONTRACT_DATA_PUBLISHER = keccak256("CONTRACT_DATA_PUBLISHER"); bytes32 constant CONTRACT_TREASURY = keccak256("CONTRACT_TREASURY"); bytes32 constant CONTRACT_SWAPPER_ENGINE = keccak256("CONTRACT_SWAPPER_ENGINE"); bytes32 constant CONTRACT_AIRDROP_DISTRIBUTION = keccak256("CONTRACT_AIRDROP_DISTRIBUTION"); bytes32 constant CONTRACT_AIRDROP_TAX_COLLECTOR = keccak256("CONTRACT_AIRDROP_TAX_COLLECTOR"); bytes32 constant CONTRACT_DISTRIBUTION_MODULE = keccak256("CONTRACT_DISTRIBUTION_MODULE"); /* Registry */ bytes32 constant CONTRACT_REGISTRY = keccak256("CONTRACT_REGISTRY"); // Not set on production /* Contract tokens */ bytes32 constant CONTRACT_USD0 = keccak256("CONTRACT_USD0"); bytes32 constant CONTRACT_USUAL = keccak256("CONTRACT_USUAL"); bytes32 constant CONTRACT_USDC = keccak256("CONTRACT_USDC"); bytes32 constant CONTRACT_USUALX = keccak256("CONTRACT_USUALX"); /* Token names and symbols */ string constant USUALSSymbol = "USUAL*"; string constant USUALSName = "USUAL Star"; string constant USUALSymbol = "USUAL"; string constant USUALName = "USUAL"; string constant USUALXSymbol = "USUALX"; string constant USUALXName = "USUALX"; /* Constants */ uint256 constant SCALAR_ONE = 1e18; uint256 constant BPS_SCALAR = 10_000; // 10000 basis points = 100% uint256 constant DISTRIBUTION_FREQUENCY_SCALAR = 1 days; uint256 constant SCALAR_TEN_KWEI = 10_000; uint256 constant MAX_REDEEM_FEE = 2500; uint256 constant MINIMUM_USDC_PROVIDED = 100e6; //minimum of 100 USDC deposit; // we take 12sec as the average block time // 1 year = 3600sec * 24 hours * 365 days * 4 years = 126_144_000 + 1 day // adding a leap day uint256 constant BOND_DURATION_FOUR_YEAR = 126_230_400; //including a leap day; uint256 constant USUAL_DISTRIBUTION_CHALLENGE_PERIOD = 1 weeks; uint256 constant BASIS_POINT_BASE = 10_000; uint256 constant VESTING_DURATION_THREE_YEARS = 94_608_000; // 3 years uint256 constant USUALSP_VESTING_STARTING_DATE = 1_732_530_600; // Mon Nov 25 2024 10:30:00 GMT+0000 uint256 constant STARTDATE_USUAL_CLAIMING_USUALSP = 1_764_066_600; // Tue Nov 25 2025 10:30:00 GMT+0000 uint256 constant STARTDATE_USUAL_CLAIMING_DISTRIBUTION_MODULE = 1_734_343_200; // Dec 16 2024 10:00:00 GMT+0000 uint256 constant AIRDROP_INITIAL_START_TIME = 1_734_343_200; // Dec 16 2024 10:00:00 GMT+0000 uint256 constant AIRDROP_VESTING_DURATION_IN_MONTHS = 6; uint256 constant ONE_YEAR = 31_536_000; // 365 days uint256 constant SIX_MONTHS = 15_768_000; uint256 constant ONE_MONTH = 2_628_000; // ONE_YEAR / 12 = 30,4 days uint64 constant ONE_WEEK = 604_800; uint256 constant NUMBER_OF_MONTHS_IN_THREE_YEARS = 36; uint256 constant END_OF_EARLY_UNLOCK_PERIOD = 1_735_686_000; // 31st Dec 2024 23:00:00 GMT+0000 uint256 constant FIRST_AIRDROP_VESTING_CLAIMING_DATE = 1_737_021_600; // 16th Jan 2025 10:00:00 GMT+0000 uint256 constant SECOND_AIRDROP_VESTING_CLAIMING_DATE = 1_739_700_000; // 16th Feb 2025 10:00:00 GMT+0000 uint256 constant THIRD_AIRDROP_VESTING_CLAIMING_DATE = 1_742_119_200; // 16th Mar 2025 10:00:00 GMT+0000 uint256 constant FOURTH_AIRDROP_VESTING_CLAIMING_DATE = 1_744_794_000; // 16th Apr 2025 09:00:00 GMT+0000 uint256 constant FIFTH_AIRDROP_VESTING_CLAIMING_DATE = 1_747_386_000; // 16th May 2025 9:00:00 GMT+0000 uint256 constant SIXTH_AIRDROP_VESTING_CLAIMING_DATE = 1_750_068_000; // 16th Jun 2025 10:00:00 GMT+0000 uint256 constant INITIAL_FLOOR_PRICE = 999_500_000_000_000_000; // 1 USD0++ = 0.9995 USD0 /* UsualX initial withdraw fee */ uint256 constant USUALX_WITHDRAW_FEE = 1000; // in BPS 10% /* Usual Distribution Bucket Distribution Shares */ uint256 constant LBT_DISTRIBUTION_SHARE = 3552; uint256 constant LYT_DISTRIBUTION_SHARE = 1026; // USD0/USD0++ AND USD0/USDC summed up uint256 constant IYT_DISTRIBUTION_SHARE = 0; uint256 constant BRIBE_DISTRIBUTION_SHARE = 346; uint256 constant ECO_DISTRIBUTION_SHARE = 0; uint256 constant DAO_DISTRIBUTION_SHARE = 1620; uint256 constant MARKET_MAKERS_DISTRIBUTION_SHARE = 0; uint256 constant USUALX_DISTRIBUTION_SHARE = 1728; uint256 constant USUALSTAR_DISTRIBUTION_SHARE = 1728; uint256 constant INITIAL_BASE_GAMMA = 7894; // 78.94 uint256 constant ONE_USDC = 1e6; uint256 constant MAX_25_PERCENT_WITHDRAW_FEE = 2500; // 25% fee uint256 constant YIELD_PRECISION = 1 days; uint256 constant USUALS_TOTAL_SUPPLY = 360_000_000e18; /* Token Addresses */ address constant USYC = 0x136471a34f6ef19fE571EFFC1CA711fdb8E49f2b; /* * The maximum relative price difference between two oracle responses allowed in order for the PriceFeed * to return to using the Oracle oracle. 18-digit precision. */ uint256 constant INITIAL_MAX_DEPEG_THRESHOLD = 100; /* Maximum number of RWA tokens that can be associated with USD0 */ uint256 constant MAX_RWA_COUNT = 10; /* Curvepool Addresses */ address constant CURVE_POOL_USD0_USD0PP = 0x1d08E7adC263CfC70b1BaBe6dC5Bb339c16Eec52; int128 constant CURVE_POOL_USD0_USD0PP_INTEGER_FOR_USD0 = 0; int128 constant CURVE_POOL_USD0_USD0PP_INTEGER_FOR_USD0PP = 1; /* Airdrop */ uint256 constant AIRDROP_CLAIMING_PERIOD_LENGTH = 182 days; /* Distribution */ uint256 constant RATE0 = 545; // 5.45% in basis points /* Hexagate */ address constant HEXAGATE_PAUSER = 0x114644925eD9A6Ab20bF85f36F1a458DF181b57B; /* Mainnet Usual Deployment */ address constant USUAL_MULTISIG_MAINNET = 0x6e9d65eC80D69b1f508560Bc7aeA5003db1f7FB7; address constant USUAL_PROXY_ADMIN_MAINNET = 0xaaDa24358620d4638a2eE8788244c6F4b197Ca16; address constant REGISTRY_CONTRACT_MAINNET = 0x0594cb5ca47eFE1Ff25C7B8B43E221683B4Db34c;
// SPDX-License-Identifier: Apache-2.0 pragma solidity 0.8.20; error AlreadyClaimed(); error NothingToClaim(); error AlreadyWhitelisted(); error AmountTooBig(); error AmountTooLow(); error AmountIsZero(); error Blacklisted(); error ExpiredSignature(uint256 deadline); error SameValue(); error Invalid(); error InvalidInput(); error InvalidToken(); error InvalidName(); error InvalidSigner(address owner); error InvalidDeadline(uint256 approvalDeadline, uint256 intentDeadline); error NoOrdersIdsProvided(); error InvalidSymbol(); error InvalidInputArraysLength(); error NotAuthorized(); error NotClaimableYet(); error NullAddress(); error NullContract(); error OracleNotWorkingNotCurrent(); error OracleNotInitialized(); error OutOfBounds(); error InvalidTimeout(); error RedeemMustNotBePaused(); error RedeemMustBePaused(); error SwapMustNotBePaused(); error SwapMustBePaused(); error StablecoinDepeg(); error DepegThresholdTooHigh(); error BondNotStarted(); error BondFinished(); error BondNotFinished(); error CliffBiggerThanDuration(); error BeginInPast(); error EndTimeBeforeStartTime(); error StartTimeInPast(); error AlreadyStarted(); error CBRIsTooHigh(); error CBRIsNull(); error RedeemFeeTooBig(); error TooManyRWA(); error InsufficientUSD0Balance(); error InsufficientUsualSLiquidAllocation(); error CannotReduceAllocation(); error OrderNotActive(); error NotRequester(); error ApprovalFailed(); error AmountExceedBacking(); error InvalidOrderAmount(address account, uint256 amount); error PARNotRequired(); error PARNotSuccessful(); error PARUSD0InputExceedsBalance(); error NullMerkleRoot(); error InvalidProof(); error PercentagesSumNotEqualTo100Percent(); error CannotDistributeUsualMoreThanOnceADay(); error NoOffChainDistributionToApprove(); error NoTokensToClaim(); error InvalidOrderId(uint80 roundId); error NotOwner(); error InvalidClaimingPeriodStartDate(); error InvalidMaxChargeableTax(); error NotInClaimingPeriod(); error ClaimerHasPaidTax(); error ZeroYieldAmount(); error StartTimeNotInFuture(); error StartTimeBeforePeriodFinish(); error CurrentTimeBeforePeriodFinish(); error EndTimeNotAfterStartTime(); error InsufficientAssetsForYield(); error NotPermittedToEarlyUnlock(); error OutsideEarlyUnlockTimeframe(); error AirdropVoided(); error FloorPriceTooHigh(); error AmountMustBeGreaterThanZero(); error InsufficientUsd0ppBalance(); error FloorPriceNotSet();
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.20; /** * @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 value of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the value of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves a `value` amount of tokens from the caller's account to `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, uint256 value) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets a `value` amount of tokens as the allowance of `spender` over the * caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 value) external returns (bool); /** * @dev Moves a `value` amount of tokens from `from` to `to` using the * allowance mechanism. `value` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 value) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol) pragma solidity ^0.8.20; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev The ETH balance of the account is not enough to perform the operation. */ error AddressInsufficientBalance(address account); /** * @dev There's no code at `target` (it is not a contract). */ error AddressEmptyCode(address target); /** * @dev A call to an address target failed. The target may have reverted. */ error FailedInnerCall(); /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { if (address(this).balance < amount) { revert AddressInsufficientBalance(address(this)); } (bool success, ) = recipient.call{value: amount}(""); if (!success) { revert FailedInnerCall(); } } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason or custom error, it is bubbled * up by this function (like regular Solidity function calls). However, if * the call reverted with no returned reason, this function reverts with a * {FailedInnerCall} error. * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { if (address(this).balance < value) { revert AddressInsufficientBalance(address(this)); } (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an * unsuccessful call. */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata ) internal view returns (bytes memory) { if (!success) { _revert(returndata); } else { // only check if target is a contract if the call was successful and the return data is empty // otherwise we already know that it was a contract if (returndata.length == 0 && target.code.length == 0) { revert AddressEmptyCode(target); } return returndata; } } /** * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the * revert reason or with a default {FailedInnerCall} error. */ function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) { if (!success) { _revert(returndata); } else { return returndata; } } /** * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}. */ function _revert(bytes memory returndata) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert FailedInnerCall(); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "./IERC20.sol"; import {IERC20Metadata} from "./extensions/IERC20Metadata.sol"; import {Context} from "../../utils/Context.sol"; import {IERC20Errors} from "../../interfaces/draft-IERC6093.sol"; /** * @dev Implementation of the {IERC20} interface. * * This implementation is agnostic to the way tokens are created. This means * that a supply mechanism has to be added in a derived contract using {_mint}. * * TIP: For a detailed writeup see our guide * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How * to implement supply mechanisms]. * * The default value of {decimals} is 18. To change this, you should override * this function so it returns a different value. * * We have followed general OpenZeppelin Contracts guidelines: functions revert * instead returning `false` on failure. This behavior is nonetheless * conventional and does not conflict with the expectations of 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. */ abstract contract ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors { mapping(address account => uint256) private _balances; mapping(address account => mapping(address spender => uint256)) private _allowances; uint256 private _totalSupply; string private _name; string private _symbol; /** * @dev Sets the values for {name} and {symbol}. * * All two of these values are immutable: they can only be set once during * construction. */ constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; } /** * @dev Returns the name of the token. */ function name() public view virtual returns (string memory) { return _name; } /** * @dev Returns the symbol of the token, usually a shorter version of the * name. */ function symbol() public view virtual returns (string memory) { return _symbol; } /** * @dev Returns the number of decimals used to get its user representation. * For example, if `decimals` equals `2`, a balance of `505` tokens should * be displayed to a user as `5.05` (`505 / 10 ** 2`). * * Tokens usually opt for a value of 18, imitating the relationship between * Ether and Wei. This is the default value returned by this function, unless * it's overridden. * * NOTE: This information is only used for _display_ purposes: it in * no way affects any of the arithmetic of the contract, including * {IERC20-balanceOf} and {IERC20-transfer}. */ function decimals() public view virtual returns (uint8) { return 18; } /** * @dev See {IERC20-totalSupply}. */ function totalSupply() public view virtual returns (uint256) { return _totalSupply; } /** * @dev See {IERC20-balanceOf}. */ function balanceOf(address account) public view virtual returns (uint256) { return _balances[account]; } /** * @dev See {IERC20-transfer}. * * Requirements: * * - `to` cannot be the zero address. * - the caller must have a balance of at least `value`. */ function transfer(address to, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _transfer(owner, to, value); return true; } /** * @dev See {IERC20-allowance}. */ function allowance(address owner, address spender) public view virtual returns (uint256) { return _allowances[owner][spender]; } /** * @dev See {IERC20-approve}. * * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on * `transferFrom`. This is semantically equivalent to an infinite approval. * * Requirements: * * - `spender` cannot be the zero address. */ function approve(address spender, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _approve(owner, spender, value); return true; } /** * @dev See {IERC20-transferFrom}. * * 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 `value`. * - the caller must have allowance for ``from``'s tokens of at least * `value`. */ function transferFrom(address from, address to, uint256 value) public virtual returns (bool) { address spender = _msgSender(); _spendAllowance(from, spender, value); _transfer(from, to, value); return true; } /** * @dev Moves a `value` amount of tokens from `from` to `to`. * * This internal function is equivalent to {transfer}, and can be used to * e.g. implement automatic token fees, slashing mechanisms, etc. * * Emits a {Transfer} event. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _transfer(address from, address to, uint256 value) internal { if (from == address(0)) { revert ERC20InvalidSender(address(0)); } if (to == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(from, to, value); } /** * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from` * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding * this function. * * Emits a {Transfer} event. */ function _update(address from, address to, uint256 value) internal virtual { if (from == address(0)) { // Overflow check required: The rest of the code assumes that totalSupply never overflows _totalSupply += value; } else { uint256 fromBalance = _balances[from]; if (fromBalance < value) { revert ERC20InsufficientBalance(from, fromBalance, value); } unchecked { // Overflow not possible: value <= fromBalance <= totalSupply. _balances[from] = fromBalance - value; } } if (to == address(0)) { unchecked { // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply. _totalSupply -= value; } } else { unchecked { // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256. _balances[to] += value; } } emit Transfer(from, to, value); } /** * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0). * Relies on the `_update` mechanism * * Emits a {Transfer} event with `from` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _mint(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(address(0), account, value); } /** * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply. * Relies on the `_update` mechanism. * * Emits a {Transfer} event with `to` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead */ function _burn(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidSender(address(0)); } _update(account, address(0), value); } /** * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens. * * This internal function is equivalent to `approve`, and can be used to * e.g. set automatic allowances for certain subsystems, etc. * * Emits an {Approval} event. * * Requirements: * * - `owner` cannot be the zero address. * - `spender` cannot be the zero address. * * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument. */ function _approve(address owner, address spender, uint256 value) internal { _approve(owner, spender, value, true); } /** * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event. * * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any * `Approval` event during `transferFrom` operations. * * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to * true using the following override: * ``` * function _approve(address owner, address spender, uint256 value, bool) internal virtual override { * super._approve(owner, spender, value, true); * } * ``` * * Requirements are the same as {_approve}. */ function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual { if (owner == address(0)) { revert ERC20InvalidApprover(address(0)); } if (spender == address(0)) { revert ERC20InvalidSpender(address(0)); } _allowances[owner][spender] = value; if (emitEvent) { emit Approval(owner, spender, value); } } /** * @dev Updates `owner` s allowance for `spender` based on spent `value`. * * Does not update the allowance value in case of infinite allowance. * Revert if not enough allowance is available. * * Does not emit an {Approval} event. */ function _spendAllowance(address owner, address spender, uint256 value) internal virtual { uint256 currentAllowance = allowance(owner, spender); if (currentAllowance != type(uint256).max) { if (currentAllowance < value) { revert ERC20InsufficientAllowance(spender, currentAllowance, value); } unchecked { _approve(owner, spender, currentAllowance - value, false); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC4626.sol) pragma solidity ^0.8.20; import {IERC20} from "../token/ERC20/IERC20.sol"; import {IERC20Metadata} from "../token/ERC20/extensions/IERC20Metadata.sol"; /** * @dev Interface of the ERC4626 "Tokenized Vault Standard", as defined in * https://eips.ethereum.org/EIPS/eip-4626[ERC-4626]. */ interface IERC4626 is IERC20, IERC20Metadata { event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares); event Withdraw( address indexed sender, address indexed receiver, address indexed owner, uint256 assets, uint256 shares ); /** * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing. * * - MUST be an ERC-20 token contract. * - MUST NOT revert. */ function asset() external view returns (address assetTokenAddress); /** * @dev Returns the total amount of the underlying asset that is “managed” by Vault. * * - SHOULD include any compounding that occurs from yield. * - MUST be inclusive of any fees that are charged against assets in the Vault. * - MUST NOT revert. */ function totalAssets() external view returns (uint256 totalManagedAssets); /** * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal * scenario where all the conditions are met. * * - MUST NOT be inclusive of any fees that are charged against assets in the Vault. * - MUST NOT show any variations depending on the caller. * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange. * - MUST NOT revert. * * NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the * “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and * from. */ function convertToShares(uint256 assets) external view returns (uint256 shares); /** * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal * scenario where all the conditions are met. * * - MUST NOT be inclusive of any fees that are charged against assets in the Vault. * - MUST NOT show any variations depending on the caller. * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange. * - MUST NOT revert. * * NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the * “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and * from. */ function convertToAssets(uint256 shares) external view returns (uint256 assets); /** * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver, * through a deposit call. * * - MUST return a limited value if receiver is subject to some deposit limit. * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited. * - MUST NOT revert. */ function maxDeposit(address receiver) external view returns (uint256 maxAssets); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given * current on-chain conditions. * * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit * call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called * in the same transaction. * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the * deposit would be accepted, regardless if the user has enough tokens approved, etc. * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by depositing. */ function previewDeposit(uint256 assets) external view returns (uint256 shares); /** * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens. * * - MUST emit the Deposit event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the * deposit execution, and are accounted for during deposit. * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not * approving enough underlying tokens to the Vault contract, etc). * * NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token. */ function deposit(uint256 assets, address receiver) external returns (uint256 shares); /** * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call. * - MUST return a limited value if receiver is subject to some mint limit. * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted. * - MUST NOT revert. */ function maxMint(address receiver) external view returns (uint256 maxShares); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given * current on-chain conditions. * * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call * in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the * same transaction. * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint * would be accepted, regardless if the user has enough tokens approved, etc. * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by minting. */ function previewMint(uint256 shares) external view returns (uint256 assets); /** * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens. * * - MUST emit the Deposit event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint * execution, and are accounted for during mint. * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not * approving enough underlying tokens to the Vault contract, etc). * * NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token. */ function mint(uint256 shares, address receiver) external returns (uint256 assets); /** * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the * Vault, through a withdraw call. * * - MUST return a limited value if owner is subject to some withdrawal limit or timelock. * - MUST NOT revert. */ function maxWithdraw(address owner) external view returns (uint256 maxAssets); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block, * given current on-chain conditions. * * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw * call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if * called * in the same transaction. * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though * the withdrawal would be accepted, regardless if the user has enough shares, etc. * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by depositing. */ function previewWithdraw(uint256 assets) external view returns (uint256 shares); /** * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver. * * - MUST emit the Withdraw event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the * withdraw execution, and are accounted for during withdraw. * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner * not having enough shares, etc). * * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed. * Those methods should be performed separately. */ function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares); /** * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault, * through a redeem call. * * - MUST return a limited value if owner is subject to some withdrawal limit or timelock. * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock. * - MUST NOT revert. */ function maxRedeem(address owner) external view returns (uint256 maxShares); /** * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block, * given current on-chain conditions. * * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call * in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the * same transaction. * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the * redemption would be accepted, regardless if the user has enough shares, etc. * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees. * - MUST NOT revert. * * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in * share price or some other type of condition, meaning the depositor will lose assets by redeeming. */ function previewRedeem(uint256 shares) external view returns (uint256 assets); /** * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver. * * - MUST emit the Withdraw event. * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the * redeem execution, and are accounted for during redeem. * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner * not having enough shares, etc). * * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed. * Those methods should be performed separately. */ function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. */ interface IERC20Metadata is IERC20 { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @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 ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol) pragma solidity ^0.8.20; /** * @dev Standard ERC20 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens. */ interface IERC20Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC20InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC20InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers. * @param spender Address that may be allowed to operate on tokens without being their owner. * @param allowance Amount of tokens a `spender` is allowed to operate with. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC20InvalidApprover(address approver); /** * @dev Indicates a failure with the `spender` to be approved. Used in approvals. * @param spender Address that may be allowed to operate on tokens without being their owner. */ error ERC20InvalidSpender(address spender); } /** * @dev Standard ERC721 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens. */ interface IERC721Errors { /** * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20. * Used in balance queries. * @param owner Address of the current owner of a token. */ error ERC721InvalidOwner(address owner); /** * @dev Indicates a `tokenId` whose `owner` is the zero address. * @param tokenId Identifier number of a token. */ error ERC721NonexistentToken(uint256 tokenId); /** * @dev Indicates an error related to the ownership over a particular token. Used in transfers. * @param sender Address whose tokens are being transferred. * @param tokenId Identifier number of a token. * @param owner Address of the current owner of a token. */ error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC721InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC721InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param tokenId Identifier number of a token. */ error ERC721InsufficientApproval(address operator, uint256 tokenId); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC721InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC721InvalidOperator(address operator); } /** * @dev Standard ERC1155 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens. */ interface IERC1155Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. * @param tokenId Identifier number of a token. */ error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC1155InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC1155InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param owner Address of the current owner of a token. */ error ERC1155MissingApprovalForAll(address operator, address owner); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC1155InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC1155InvalidOperator(address operator); /** * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation. * Used in batch transfers. * @param idsLength Length of the array of token identifiers * @param valuesLength Length of the array of token amounts */ error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.20; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Storage of the initializable contract. * * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions * when using with upgradeable contracts. * * @custom:storage-location erc7201:openzeppelin.storage.Initializable */ struct InitializableStorage { /** * @dev Indicates that the contract has been initialized. */ uint64 _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool _initializing; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00; /** * @dev The contract is already initialized. */ error InvalidInitialization(); /** * @dev The contract is not initializing. */ error NotInitializing(); /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint64 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in * production. * * Emits an {Initialized} event. */ modifier initializer() { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); // Cache values to avoid duplicated sloads bool isTopLevelCall = !$._initializing; uint64 initialized = $._initialized; // Allowed calls: // - initialSetup: the contract is not in the initializing state and no previous version was // initialized // - construction: the contract is initialized at version 1 (no reininitialization) and the // current contract is just being deployed bool initialSetup = initialized == 0 && isTopLevelCall; bool construction = initialized == 1 && address(this).code.length == 0; if (!initialSetup && !construction) { revert InvalidInitialization(); } $._initialized = 1; if (isTopLevelCall) { $._initializing = true; } _; if (isTopLevelCall) { $._initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint64 version) { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); if ($._initializing || $._initialized >= version) { revert InvalidInitialization(); } $._initialized = version; $._initializing = true; _; $._initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { _checkInitializing(); _; } /** * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}. */ function _checkInitializing() internal view virtual { if (!_isInitializing()) { revert NotInitializing(); } } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. * * Emits an {Initialized} event the first time it is successfully executed. */ function _disableInitializers() internal virtual { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); if ($._initializing) { revert InvalidInitialization(); } if ($._initialized != type(uint64).max) { $._initialized = type(uint64).max; emit Initialized(type(uint64).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint64) { return _getInitializableStorage()._initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _getInitializableStorage()._initializing; } /** * @dev Returns a pointer to the storage namespace. */ // solhint-disable-next-line var-name-mixedcase function _getInitializableStorage() private pure returns (InitializableStorage storage $) { assembly { $.slot := INITIALIZABLE_STORAGE } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/cryptography/MessageHashUtils.sol) pragma solidity ^0.8.20; import {Strings} from "../Strings.sol"; /** * @dev Signature message hash utilities for producing digests to be consumed by {ECDSA} recovery or signing. * * The library provides methods for generating a hash of a message that conforms to the * https://eips.ethereum.org/EIPS/eip-191[EIP 191] and https://eips.ethereum.org/EIPS/eip-712[EIP 712] * specifications. */ library MessageHashUtils { /** * @dev Returns the keccak256 digest of an EIP-191 signed data with version * `0x45` (`personal_sign` messages). * * The digest is calculated by prefixing a bytes32 `messageHash` with * `"\x19Ethereum Signed Message:\n32"` and hashing the result. It corresponds with the * hash signed when using the https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] JSON-RPC method. * * NOTE: The `messageHash` parameter is intended to be the result of hashing a raw message with * keccak256, although any bytes32 value can be safely used because the final digest will * be re-hashed. * * See {ECDSA-recover}. */ function toEthSignedMessageHash(bytes32 messageHash) internal pure returns (bytes32 digest) { /// @solidity memory-safe-assembly assembly { mstore(0x00, "\x19Ethereum Signed Message:\n32") // 32 is the bytes-length of messageHash mstore(0x1c, messageHash) // 0x1c (28) is the length of the prefix digest := keccak256(0x00, 0x3c) // 0x3c is the length of the prefix (0x1c) + messageHash (0x20) } } /** * @dev Returns the keccak256 digest of an EIP-191 signed data with version * `0x45` (`personal_sign` messages). * * The digest is calculated by prefixing an arbitrary `message` with * `"\x19Ethereum Signed Message:\n" + len(message)` and hashing the result. It corresponds with the * hash signed when using the https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] JSON-RPC method. * * See {ECDSA-recover}. */ function toEthSignedMessageHash(bytes memory message) internal pure returns (bytes32) { return keccak256(bytes.concat("\x19Ethereum Signed Message:\n", bytes(Strings.toString(message.length)), message)); } /** * @dev Returns the keccak256 digest of an EIP-191 signed data with version * `0x00` (data with intended validator). * * The digest is calculated by prefixing an arbitrary `data` with `"\x19\x00"` and the intended * `validator` address. Then hashing the result. * * See {ECDSA-recover}. */ function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) { return keccak256(abi.encodePacked(hex"19_00", validator, data)); } /** * @dev Returns the keccak256 digest of an EIP-712 typed data (EIP-191 version `0x01`). * * The digest is calculated from a `domainSeparator` and a `structHash`, by prefixing them with * `\x19\x01` and hashing the result. It corresponds to the hash signed by the * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] JSON-RPC method as part of EIP-712. * * See {ECDSA-recover}. */ function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 digest) { /// @solidity memory-safe-assembly assembly { let ptr := mload(0x40) mstore(ptr, hex"19_01") mstore(add(ptr, 0x02), domainSeparator) mstore(add(ptr, 0x22), structHash) digest := keccak256(ptr, 0x42) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC5267.sol) pragma solidity ^0.8.20; interface IERC5267 { /** * @dev MAY be emitted to signal that the domain could have changed. */ event EIP712DomainChanged(); /** * @dev returns the fields and values that describe the domain separator used by this contract for EIP-712 * signature. */ function eip712Domain() external view returns ( bytes1 fields, string memory name, string memory version, uint256 chainId, address verifyingContract, bytes32 salt, uint256[] memory extensions ); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/extensions/IAccessControlDefaultAdminRules.sol) pragma solidity ^0.8.20; import {IAccessControl} from "../IAccessControl.sol"; /** * @dev External interface of AccessControlDefaultAdminRules declared to support ERC165 detection. */ interface IAccessControlDefaultAdminRules is IAccessControl { /** * @dev The new default admin is not a valid default admin. */ error AccessControlInvalidDefaultAdmin(address defaultAdmin); /** * @dev At least one of the following rules was violated: * * - The `DEFAULT_ADMIN_ROLE` must only be managed by itself. * - The `DEFAULT_ADMIN_ROLE` must only be held by one account at the time. * - Any `DEFAULT_ADMIN_ROLE` transfer must be in two delayed steps. */ error AccessControlEnforcedDefaultAdminRules(); /** * @dev The delay for transferring the default admin delay is enforced and * the operation must wait until `schedule`. * * NOTE: `schedule` can be 0 indicating there's no transfer scheduled. */ error AccessControlEnforcedDefaultAdminDelay(uint48 schedule); /** * @dev Emitted when a {defaultAdmin} transfer is started, setting `newAdmin` as the next * address to become the {defaultAdmin} by calling {acceptDefaultAdminTransfer} only after `acceptSchedule` * passes. */ event DefaultAdminTransferScheduled(address indexed newAdmin, uint48 acceptSchedule); /** * @dev Emitted when a {pendingDefaultAdmin} is reset if it was never accepted, regardless of its schedule. */ event DefaultAdminTransferCanceled(); /** * @dev Emitted when a {defaultAdminDelay} change is started, setting `newDelay` as the next * delay to be applied between default admin transfer after `effectSchedule` has passed. */ event DefaultAdminDelayChangeScheduled(uint48 newDelay, uint48 effectSchedule); /** * @dev Emitted when a {pendingDefaultAdminDelay} is reset if its schedule didn't pass. */ event DefaultAdminDelayChangeCanceled(); /** * @dev Returns the address of the current `DEFAULT_ADMIN_ROLE` holder. */ function defaultAdmin() external view returns (address); /** * @dev Returns a tuple of a `newAdmin` and an accept schedule. * * After the `schedule` passes, the `newAdmin` will be able to accept the {defaultAdmin} role * by calling {acceptDefaultAdminTransfer}, completing the role transfer. * * A zero value only in `acceptSchedule` indicates no pending admin transfer. * * NOTE: A zero address `newAdmin` means that {defaultAdmin} is being renounced. */ function pendingDefaultAdmin() external view returns (address newAdmin, uint48 acceptSchedule); /** * @dev Returns the delay required to schedule the acceptance of a {defaultAdmin} transfer started. * * This delay will be added to the current timestamp when calling {beginDefaultAdminTransfer} to set * the acceptance schedule. * * NOTE: If a delay change has been scheduled, it will take effect as soon as the schedule passes, making this * function returns the new delay. See {changeDefaultAdminDelay}. */ function defaultAdminDelay() external view returns (uint48); /** * @dev Returns a tuple of `newDelay` and an effect schedule. * * After the `schedule` passes, the `newDelay` will get into effect immediately for every * new {defaultAdmin} transfer started with {beginDefaultAdminTransfer}. * * A zero value only in `effectSchedule` indicates no pending delay change. * * NOTE: A zero value only for `newDelay` means that the next {defaultAdminDelay} * will be zero after the effect schedule. */ function pendingDefaultAdminDelay() external view returns (uint48 newDelay, uint48 effectSchedule); /** * @dev Starts a {defaultAdmin} transfer by setting a {pendingDefaultAdmin} scheduled for acceptance * after the current timestamp plus a {defaultAdminDelay}. * * Requirements: * * - Only can be called by the current {defaultAdmin}. * * Emits a DefaultAdminRoleChangeStarted event. */ function beginDefaultAdminTransfer(address newAdmin) external; /** * @dev Cancels a {defaultAdmin} transfer previously started with {beginDefaultAdminTransfer}. * * A {pendingDefaultAdmin} not yet accepted can also be cancelled with this function. * * Requirements: * * - Only can be called by the current {defaultAdmin}. * * May emit a DefaultAdminTransferCanceled event. */ function cancelDefaultAdminTransfer() external; /** * @dev Completes a {defaultAdmin} transfer previously started with {beginDefaultAdminTransfer}. * * After calling the function: * * - `DEFAULT_ADMIN_ROLE` should be granted to the caller. * - `DEFAULT_ADMIN_ROLE` should be revoked from the previous holder. * - {pendingDefaultAdmin} should be reset to zero values. * * Requirements: * * - Only can be called by the {pendingDefaultAdmin}'s `newAdmin`. * - The {pendingDefaultAdmin}'s `acceptSchedule` should've passed. */ function acceptDefaultAdminTransfer() external; /** * @dev Initiates a {defaultAdminDelay} update by setting a {pendingDefaultAdminDelay} scheduled for getting * into effect after the current timestamp plus a {defaultAdminDelay}. * * This function guarantees that any call to {beginDefaultAdminTransfer} done between the timestamp this * method is called and the {pendingDefaultAdminDelay} effect schedule will use the current {defaultAdminDelay} * set before calling. * * The {pendingDefaultAdminDelay}'s effect schedule is defined in a way that waiting until the schedule and then * calling {beginDefaultAdminTransfer} with the new delay will take at least the same as another {defaultAdmin} * complete transfer (including acceptance). * * The schedule is designed for two scenarios: * * - When the delay is changed for a larger one the schedule is `block.timestamp + newDelay` capped by * {defaultAdminDelayIncreaseWait}. * - When the delay is changed for a shorter one, the schedule is `block.timestamp + (current delay - new delay)`. * * A {pendingDefaultAdminDelay} that never got into effect will be canceled in favor of a new scheduled change. * * Requirements: * * - Only can be called by the current {defaultAdmin}. * * Emits a DefaultAdminDelayChangeScheduled event and may emit a DefaultAdminDelayChangeCanceled event. */ function changeDefaultAdminDelay(uint48 newDelay) external; /** * @dev Cancels a scheduled {defaultAdminDelay} change. * * Requirements: * * - Only can be called by the current {defaultAdmin}. * * May emit a DefaultAdminDelayChangeCanceled event. */ function rollbackDefaultAdminDelay() external; /** * @dev Maximum time in seconds for an increase to {defaultAdminDelay} (that is scheduled using {changeDefaultAdminDelay}) * to take effect. Default to 5 days. * * When the {defaultAdminDelay} is scheduled to be increased, it goes into effect after the new delay has passed with * the purpose of giving enough time for reverting any accidental change (i.e. using milliseconds instead of seconds) * that may lock the contract. However, to avoid excessive schedules, the wait is capped by this function and it can * be overrode for a custom {defaultAdminDelay} increase scheduling. * * IMPORTANT: Make sure to add a reasonable amount of time while overriding this value, otherwise, * there's a risk of setting a high new delay that goes into effect almost immediately without the * possibility of human intervention in the case of an input error (eg. set milliseconds instead of seconds). */ function defaultAdminDelayIncreaseWait() external view returns (uint48); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/ERC4626.sol) pragma solidity ^0.8.20; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {ERC20Upgradeable} from "../ERC20Upgradeable.sol"; import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import {IERC4626} from "@openzeppelin/contracts/interfaces/IERC4626.sol"; import {Math} from "@openzeppelin/contracts/utils/math/Math.sol"; import {Initializable} from "../../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the ERC4626 "Tokenized Vault Standard" as defined in * https://eips.ethereum.org/EIPS/eip-4626[EIP-4626]. * * This extension allows the minting and burning of "shares" (represented using the ERC20 inheritance) in exchange for * underlying "assets" through standardized {deposit}, {mint}, {redeem} and {burn} workflows. This contract extends * the ERC20 standard. Any additional extensions included along it would affect the "shares" token represented by this * contract and not the "assets" token which is an independent contract. * * [CAUTION] * ==== * In empty (or nearly empty) ERC-4626 vaults, deposits are at high risk of being stolen through frontrunning * with a "donation" to the vault that inflates the price of a share. This is variously known as a donation or inflation * attack and is essentially a problem of slippage. Vault deployers can protect against this attack by making an initial * deposit of a non-trivial amount of the asset, such that price manipulation becomes infeasible. Withdrawals may * similarly be affected by slippage. Users can protect against this attack as well as unexpected slippage in general by * verifying the amount received is as expected, using a wrapper that performs these checks such as * https://github.com/fei-protocol/ERC4626#erc4626router-and-base[ERC4626Router]. * * Since v4.9, this implementation uses virtual assets and shares to mitigate that risk. The `_decimalsOffset()` * corresponds to an offset in the decimal representation between the underlying asset's decimals and the vault * decimals. This offset also determines the rate of virtual shares to virtual assets in the vault, which itself * determines the initial exchange rate. While not fully preventing the attack, analysis shows that the default offset * (0) makes it non-profitable, as a result of the value being captured by the virtual shares (out of the attacker's * donation) matching the attacker's expected gains. With a larger offset, the attack becomes orders of magnitude more * expensive than it is profitable. More details about the underlying math can be found * xref:erc4626.adoc#inflation-attack[here]. * * The drawback of this approach is that the virtual shares do capture (a very small) part of the value being accrued * to the vault. Also, if the vault experiences losses, the users try to exit the vault, the virtual shares and assets * will cause the first user to exit to experience reduced losses in detriment to the last users that will experience * bigger losses. Developers willing to revert back to the pre-v4.9 behavior just need to override the * `_convertToShares` and `_convertToAssets` functions. * * To learn more, check out our xref:ROOT:erc4626.adoc[ERC-4626 guide]. * ==== */ abstract contract ERC4626Upgradeable is Initializable, ERC20Upgradeable, IERC4626 { using Math for uint256; /// @custom:storage-location erc7201:openzeppelin.storage.ERC4626 struct ERC4626Storage { IERC20 _asset; uint8 _underlyingDecimals; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC4626")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant ERC4626StorageLocation = 0x0773e532dfede91f04b12a73d3d2acd361424f41f76b4fb79f090161e36b4e00; function _getERC4626Storage() private pure returns (ERC4626Storage storage $) { assembly { $.slot := ERC4626StorageLocation } } /** * @dev Attempted to deposit more assets than the max amount for `receiver`. */ error ERC4626ExceededMaxDeposit(address receiver, uint256 assets, uint256 max); /** * @dev Attempted to mint more shares than the max amount for `receiver`. */ error ERC4626ExceededMaxMint(address receiver, uint256 shares, uint256 max); /** * @dev Attempted to withdraw more assets than the max amount for `receiver`. */ error ERC4626ExceededMaxWithdraw(address owner, uint256 assets, uint256 max); /** * @dev Attempted to redeem more shares than the max amount for `receiver`. */ error ERC4626ExceededMaxRedeem(address owner, uint256 shares, uint256 max); /** * @dev Set the underlying asset contract. This must be an ERC20-compatible contract (ERC20 or ERC777). */ function __ERC4626_init(IERC20 asset_) internal onlyInitializing { __ERC4626_init_unchained(asset_); } function __ERC4626_init_unchained(IERC20 asset_) internal onlyInitializing { ERC4626Storage storage $ = _getERC4626Storage(); (bool success, uint8 assetDecimals) = _tryGetAssetDecimals(asset_); $._underlyingDecimals = success ? assetDecimals : 18; $._asset = asset_; } /** * @dev Attempts to fetch the asset decimals. A return value of false indicates that the attempt failed in some way. */ function _tryGetAssetDecimals(IERC20 asset_) private view returns (bool, uint8) { (bool success, bytes memory encodedDecimals) = address(asset_).staticcall( abi.encodeCall(IERC20Metadata.decimals, ()) ); if (success && encodedDecimals.length >= 32) { uint256 returnedDecimals = abi.decode(encodedDecimals, (uint256)); if (returnedDecimals <= type(uint8).max) { return (true, uint8(returnedDecimals)); } } return (false, 0); } /** * @dev Decimals are computed by adding the decimal offset on top of the underlying asset's decimals. This * "original" value is cached during construction of the vault contract. If this read operation fails (e.g., the * asset has not been created yet), a default of 18 is used to represent the underlying asset's decimals. * * See {IERC20Metadata-decimals}. */ function decimals() public view virtual override(IERC20Metadata, ERC20Upgradeable) returns (uint8) { ERC4626Storage storage $ = _getERC4626Storage(); return $._underlyingDecimals + _decimalsOffset(); } /** @dev See {IERC4626-asset}. */ function asset() public view virtual returns (address) { ERC4626Storage storage $ = _getERC4626Storage(); return address($._asset); } /** @dev See {IERC4626-totalAssets}. */ function totalAssets() public view virtual returns (uint256) { ERC4626Storage storage $ = _getERC4626Storage(); return $._asset.balanceOf(address(this)); } /** @dev See {IERC4626-convertToShares}. */ function convertToShares(uint256 assets) public view virtual returns (uint256) { return _convertToShares(assets, Math.Rounding.Floor); } /** @dev See {IERC4626-convertToAssets}. */ function convertToAssets(uint256 shares) public view virtual returns (uint256) { return _convertToAssets(shares, Math.Rounding.Floor); } /** @dev See {IERC4626-maxDeposit}. */ function maxDeposit(address) public view virtual returns (uint256) { return type(uint256).max; } /** @dev See {IERC4626-maxMint}. */ function maxMint(address) public view virtual returns (uint256) { return type(uint256).max; } /** @dev See {IERC4626-maxWithdraw}. */ function maxWithdraw(address owner) public view virtual returns (uint256) { return _convertToAssets(balanceOf(owner), Math.Rounding.Floor); } /** @dev See {IERC4626-maxRedeem}. */ function maxRedeem(address owner) public view virtual returns (uint256) { return balanceOf(owner); } /** @dev See {IERC4626-previewDeposit}. */ function previewDeposit(uint256 assets) public view virtual returns (uint256) { return _convertToShares(assets, Math.Rounding.Floor); } /** @dev See {IERC4626-previewMint}. */ function previewMint(uint256 shares) public view virtual returns (uint256) { return _convertToAssets(shares, Math.Rounding.Ceil); } /** @dev See {IERC4626-previewWithdraw}. */ function previewWithdraw(uint256 assets) public view virtual returns (uint256) { return _convertToShares(assets, Math.Rounding.Ceil); } /** @dev See {IERC4626-previewRedeem}. */ function previewRedeem(uint256 shares) public view virtual returns (uint256) { return _convertToAssets(shares, Math.Rounding.Floor); } /** @dev See {IERC4626-deposit}. */ function deposit(uint256 assets, address receiver) public virtual returns (uint256) { uint256 maxAssets = maxDeposit(receiver); if (assets > maxAssets) { revert ERC4626ExceededMaxDeposit(receiver, assets, maxAssets); } uint256 shares = previewDeposit(assets); _deposit(_msgSender(), receiver, assets, shares); return shares; } /** @dev See {IERC4626-mint}. * * As opposed to {deposit}, minting is allowed even if the vault is in a state where the price of a share is zero. * In this case, the shares will be minted without requiring any assets to be deposited. */ function mint(uint256 shares, address receiver) public virtual returns (uint256) { uint256 maxShares = maxMint(receiver); if (shares > maxShares) { revert ERC4626ExceededMaxMint(receiver, shares, maxShares); } uint256 assets = previewMint(shares); _deposit(_msgSender(), receiver, assets, shares); return assets; } /** @dev See {IERC4626-withdraw}. */ function withdraw(uint256 assets, address receiver, address owner) public virtual returns (uint256) { uint256 maxAssets = maxWithdraw(owner); if (assets > maxAssets) { revert ERC4626ExceededMaxWithdraw(owner, assets, maxAssets); } uint256 shares = previewWithdraw(assets); _withdraw(_msgSender(), receiver, owner, assets, shares); return shares; } /** @dev See {IERC4626-redeem}. */ function redeem(uint256 shares, address receiver, address owner) public virtual returns (uint256) { uint256 maxShares = maxRedeem(owner); if (shares > maxShares) { revert ERC4626ExceededMaxRedeem(owner, shares, maxShares); } uint256 assets = previewRedeem(shares); _withdraw(_msgSender(), receiver, owner, assets, shares); return assets; } /** * @dev Internal conversion function (from assets to shares) with support for rounding direction. */ function _convertToShares(uint256 assets, Math.Rounding rounding) internal view virtual returns (uint256) { return assets.mulDiv(totalSupply() + 10 ** _decimalsOffset(), totalAssets() + 1, rounding); } /** * @dev Internal conversion function (from shares to assets) with support for rounding direction. */ function _convertToAssets(uint256 shares, Math.Rounding rounding) internal view virtual returns (uint256) { return shares.mulDiv(totalAssets() + 1, totalSupply() + 10 ** _decimalsOffset(), rounding); } /** * @dev Deposit/mint common workflow. */ function _deposit(address caller, address receiver, uint256 assets, uint256 shares) internal virtual { ERC4626Storage storage $ = _getERC4626Storage(); // If _asset is ERC777, `transferFrom` can trigger a reentrancy BEFORE the transfer happens through the // `tokensToSend` hook. On the other hand, the `tokenReceived` hook, that is triggered after the transfer, // calls the vault, which is assumed not malicious. // // Conclusion: we need to do the transfer before we mint so that any reentrancy would happen before the // assets are transferred and before the shares are minted, which is a valid state. // slither-disable-next-line reentrancy-no-eth SafeERC20.safeTransferFrom($._asset, caller, address(this), assets); _mint(receiver, shares); emit Deposit(caller, receiver, assets, shares); } /** * @dev Withdraw/redeem common workflow. */ function _withdraw( address caller, address receiver, address owner, uint256 assets, uint256 shares ) internal virtual { ERC4626Storage storage $ = _getERC4626Storage(); if (caller != owner) { _spendAllowance(owner, caller, shares); } // If _asset is ERC777, `transfer` can trigger a reentrancy AFTER the transfer happens through the // `tokensReceived` hook. On the other hand, the `tokensToSend` hook, that is triggered before the transfer, // calls the vault, which is assumed not malicious. // // Conclusion: we need to do the transfer after the burn so that any reentrancy would happen after the // shares are burned and after the assets are transferred, which is a valid state. _burn(owner, shares); SafeERC20.safeTransfer($._asset, receiver, assets); emit Withdraw(caller, receiver, owner, assets, shares); } function _decimalsOffset() internal view virtual returns (uint8) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol) pragma solidity ^0.8.20; import {Math} from "./math/Math.sol"; import {SignedMath} from "./math/SignedMath.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant HEX_DIGITS = "0123456789abcdef"; uint8 private constant ADDRESS_LENGTH = 20; /** * @dev The `value` string doesn't fit in the specified `length`. */ error StringsInsufficientHexLength(uint256 value, uint256 length); /** * @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), HEX_DIGITS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `int256` to its ASCII `string` decimal representation. */ function toStringSigned(int256 value) internal pure returns (string memory) { return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value))); } /** * @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) { uint256 localValue = value; 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] = HEX_DIGITS[localValue & 0xf]; localValue >>= 4; } if (localValue != 0) { revert StringsInsufficientHexLength(value, length); } 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); } /** * @dev Returns true if the two strings are equal. */ function equal(string memory a, string memory b) internal pure returns (bool) { return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/IAccessControl.sol) pragma solidity ^0.8.20; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControl { /** * @dev The `account` is missing a role. */ error AccessControlUnauthorizedAccount(address account, bytes32 neededRole); /** * @dev The caller of a function is not the expected one. * * NOTE: Don't confuse with {AccessControlUnauthorizedAccount}. */ error AccessControlBadConfirmation(); /** * @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. */ 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 `callerConfirmation`. */ function renounceRole(bytes32 role, address callerConfirmation) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SignedMath.sol) pragma solidity ^0.8.20; /** * @dev Standard signed math utilities missing in the Solidity language. */ library SignedMath { /** * @dev Returns the largest of two signed numbers. */ function max(int256 a, int256 b) internal pure returns (int256) { return a > b ? a : b; } /** * @dev Returns the smallest of two signed numbers. */ function min(int256 a, int256 b) internal pure returns (int256) { return a < b ? a : b; } /** * @dev Returns the average of two signed numbers without overflow. * The result is rounded towards zero. */ function average(int256 a, int256 b) internal pure returns (int256) { // Formula from the book "Hacker's Delight" int256 x = (a & b) + ((a ^ b) >> 1); return x + (int256(uint256(x) >> 255) & (a ^ b)); } /** * @dev Returns the absolute unsigned value of a signed value. */ function abs(int256 n) internal pure returns (uint256) { unchecked { // must be unchecked in order to support `n = type(int256).min` return uint256(n >= 0 ? n : -n); } } }
{ "remappings": [ "ds-test/=lib/forge-std/lib/ds-test/src/", "forge-std/=lib/forge-std/src/", "openzeppelin-contracts/=lib/openzeppelin-contracts/contracts/", "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/", "utils/=lib/utils/", "@openzeppelin/=lib/openzeppelin-contracts/", "solidity-stringutils/=lib/openzeppelin-foundry-upgrades/lib/solidity-stringutils/", "openzeppelin-foundry-upgrades/=lib/openzeppelin-foundry-upgrades/src/", "src/=src/" ], "optimizer": { "enabled": true, "runs": 200 }, "metadata": { "useLiteralContent": false, "bytecodeHash": "ipfs", "appendCBOR": true }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "evmVersion": "shanghai", "viaIR": false, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"AddressInsufficientBalance","type":"error"},{"inputs":[],"name":"AmountTooBig","type":"error"},{"inputs":[],"name":"Blacklisted","type":"error"},{"inputs":[],"name":"CurrentTimeBeforePeriodFinish","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxDeposit","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxMint","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxRedeem","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"uint256","name":"max","type":"uint256"}],"name":"ERC4626ExceededMaxWithdraw","type":"error"},{"inputs":[],"name":"EndTimeNotAfterStartTime","type":"error"},{"inputs":[],"name":"EnforcedPause","type":"error"},{"inputs":[],"name":"ExpectedPause","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"InsufficientAssetsForYield","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"MathOverflowedMulDiv","type":"error"},{"inputs":[],"name":"NotAuthorized","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"NullAddress","type":"error"},{"inputs":[],"name":"NullContract","type":"error"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"inputs":[],"name":"SameValue","type":"error"},{"inputs":[],"name":"StartTimeBeforePeriodFinish","type":"error"},{"inputs":[],"name":"StartTimeNotInFuture","type":"error"},{"inputs":[],"name":"ZeroYieldAmount","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Blacklist","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[],"name":"EIP712DomainChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","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":false,"internalType":"address","name":"account","type":"address"}],"name":"UnBlacklist","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newWithdrawFeeBps","type":"uint256"}],"name":"WithdrawFeeUpdated","type":"event"},{"inputs":[],"name":"UsualXStorageV0Location","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","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":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"asset","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"blacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"convertToAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"convertToShares","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"depositWithPermit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"eip712Domain","outputs":[{"internalType":"bytes1","name":"fields","type":"bytes1"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"},{"internalType":"uint256","name":"chainId","type":"uint256"},{"internalType":"address","name":"verifyingContract","type":"address"},{"internalType":"bytes32","name":"salt","type":"bytes32"},{"internalType":"uint256[]","name":"extensions","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getYieldRate","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_registryContract","type":"address"},{"internalType":"uint256","name":"_withdrawFeeBps","type":"uint256"},{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"isBlacklisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"maxDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"maxMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxRedeem","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxWithdraw","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"mint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"previewDeposit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"previewMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"previewRedeem","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"previewWithdraw","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"redeem","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"yieldAmount","type":"uint256"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"}],"name":"startYieldDistribution","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"unBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newWithdrawFeeBps","type":"uint256"}],"name":"updateWithdrawFee","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"withdraw","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawFeeBps","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]
Contract Creation Code
608060405234801562000010575f80fd5b506200001b62000021565b620000d5565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff1615620000725760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b0390811614620000d25780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b612bfc80620000e35f395ff3fe608060405234801561000f575f80fd5b5060043610610234575f3560e01c806370a0823111610135578063c63d75b6116100b4578063dd62ed3e11610079578063dd62ed3e146104dd578063ef8b30f714610491578063f1009899146104f0578063f9f92be414610517578063fe575a871461052a575f80fd5b8063c63d75b614610355578063c6e6f59214610491578063ce96cb77146104a4578063d905777e146104b7578063daf635de146104ca575f80fd5b806395d89b41116100fa57806395d89b411461043d578063a9059cbb14610445578063b3d7f6b914610458578063b460af941461046b578063ba0876521461047e575f80fd5b806370a08231146103e05780637aca2b59146103f35780638456cb591461040757806384b0196e1461040f57806394bf804d1461042a575f80fd5b8063313ce567116101c15780634cdad506116101865780634cdad5061461037c57806350921b231461038f57806353428e01146103a25780635c975abb146103b65780636e553f65146103cd575f80fd5b8063313ce5671461031357806338d52e0f1461032d5780633f4ba83a1461034d578063402d267d1461035557806348678c2314610369575f80fd5b80630a28a477116102075780630a28a4771461029e578063148f51f3146102b157806318160ddd146102c65780631a895266146102ed57806323b872dd14610300575f80fd5b806301e1d1141461023857806306fdde031461025357806307a2d13a14610268578063095ea7b31461027b575b5f80fd5b610240610574565b6040519081526020015b60405180910390f35b61025b61059f565b60405161024a91906123df565b6102406102763660046123f1565b610644565b61028e61028936600461241c565b610655565b604051901515815260200161024a565b6102406102ac3660046123f1565b61066c565b6102c46102bf3660046124e3565b6106bd565b005b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0254610240565b6102c46102fb36600461255e565b6109ac565b61028e61030e366004612579565b610a91565b61031b610ab4565b60405160ff909116815260200161024a565b610335610ae3565b6040516001600160a01b03909116815260200161024a565b6102c4610afe565b61024061036336600461255e565b505f1990565b6102c46103773660046125b7565b610b3a565b61024061038a3660046123f1565b610c18565b61024061039d3660046125e0565b610c52565b6102405f80516020612b4783398151915281565b5f80516020612b878339815191525460ff1661028e565b6102406103db36600461263d565b610d14565b6102406103ee36600461255e565b610d27565b5f80516020612b4783398151915254610240565b6102c4610d4d565b610417610da6565b60405161024a979695949392919061266b565b61024061043836600461263d565b610e54565b61025b610e67565b61028e61045336600461241c565b610ea5565b6102406104663660046123f1565b610eb2565b6102406104793660046126ff565b610ebe565b61024061048c3660046126ff565b610f81565b61024061049f3660046123f1565b611016565b6102406104b236600461255e565b611021565b6102406104c536600461255e565b61102e565b6102c46104d83660046123f1565b611038565b6102406104eb36600461273e565b6110df565b7f9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc654760154610240565b6102c461052536600461255e565b611128565b61028e61053836600461255e565b6001600160a01b03165f9081527fe34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b96795303602052604090205460ff1690565b5f5f80516020612ac78339815191528161058c611230565b8254610598919061277e565b9392505050565b60605f5f80516020612ae78339815191525b90508060030180546105c290612791565b80601f01602080910402602001604051908101604052809291908181526020018280546105ee90612791565b80156106395780601f1061061057610100808354040283529160200191610639565b820191905f5260205f20905b81548152906001019060200180831161061c57829003601f168201915b505050505091505090565b5f61064f825f6112c2565b92915050565b5f33610662818585611319565b5060019392505050565b5f80516020612b4783398151915280545f9190829061069a908590610693816127106127c9565b600161132b565b90505f6106a7828661277e565b90506106b481600161136e565b95945050505050565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff16159067ffffffffffffffff165f811580156107025750825b90505f8267ffffffffffffffff16600114801561071e5750303b155b90508115801561072c575080155b1561074a5760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff19166001178555831561077457845460ff60401b1916600160401b1785555b6001600160a01b03891661079b576040516307988a3f60e21b815260040160405180910390fd5b5f5f80516020612b478339815191526002810180546001600160a01b0319166001600160a01b038d16908117909155604051631c2d8fb360e31b81527fdbbc50039ed3ca50ec88fa75d6fe32dae25b22535afc1cd51cf4090d5ebc4d2860048201529192505f9163e16c7d9890602401602060405180830381865afa158015610826573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061084a91906127dc565b9050610857818a8a6113bc565b61085f6113df565b6108676113ff565b61088a89604051806040016040528060018152602001603160f81b815250611411565b6109c48a11156108ad57604051636b2f218360e01b815260040160405180910390fd5b898255604051631c2d8fb360e31b81527f5a92fc7720b8c2c63ba7a9aec6e2269feb0e8c23b216e4162abc2b6ed5e5a22b60048201526001600160a01b038c169063e16c7d9890602401602060405180830381865afa158015610912573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061093691906127dc565b60019290920180546001600160a01b0319166001600160a01b03909316929092179091555083156109a157845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b505050505050505050565b5f80516020612b07833981519152545f80516020612b47833981519152906109fd906001600160a01b03167f22435ed027edf5f902dc0093fbc24cdb50c05b5fd5f311b78c67c1cbaff60e13611470565b6001600160a01b0382165f90815260038201602052604090205460ff16610a375760405163c23f6ccb60e01b815260040160405180910390fd5b6001600160a01b0382165f818152600383016020908152604091829020805460ff1916905590519182527fc653d95790bb2472667b557ef27642a37cac57b69d6d5fddcaacef8f62589dcb91015b60405180910390a15050565b5f33610a9e8582856114fe565b610aa9858585611548565b506001949350505050565b5f805f80516020612b6783398151915290505f8154610add9190600160a01b900460ff166127f7565b91505090565b5f80516020612b67833981519152546001600160a01b031690565b5f80516020612b07833981519152545f80516020612b4783398151915290610b2f906001600160a01b03165f611470565b610b376115a5565b50565b5f5f80516020612b478339815191526002810154604051631c2d8fb360e31b81527fb221b00ba6c9ff59b4362c86e96b2b0d48eccfb80034a35cfd29acf81707947d60048201529192506001600160a01b03169063e16c7d9890602401602060405180830381865afa158015610bb2573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610bd691906127dc565b6001600160a01b0316336001600160a01b031614610c075760405163ea8e4eb560e01b815260040160405180910390fd5b610c12848484611604565b50505050565b5f5f80516020612b4783398151915281610c3184610644565b90505f610c4682845f0154612710600161132b565b90506106b481836127c9565b5f610c5b6117b7565b610c636117ee565b610c6b610ae3565b60405163d505accf60e01b8152336004820152306024820152604481018990526064810187905260ff8616608482015260a4810185905260c481018490526001600160a01b03919091169063d505accf9060e4015f604051808303815f87803b158015610cd6575f80fd5b505af1925050508015610ce7575060015b50610cf28787610d14565b9050610d0a60015f80516020612ba783398151915255565b9695505050505050565b5f610d1d6117ee565b6105988383611831565b6001600160a01b03165f9081525f80516020612ae7833981519152602052604090205490565b5f80516020612b07833981519152545f80516020612b4783398151915290610d9e906001600160a01b03167fe40ef4c9f0881870a532466eceeb9426f92f3b4563aab91fc873619411dc7014611470565b610b37611854565b5f60608082808083815f80516020612b278339815191528054909150158015610dd157506001810154155b610e1a5760405162461bcd60e51b81526020600482015260156024820152741152540dcc4c8e88155b9a5b9a5d1a585b1a5e9959605a1b60448201526064015b60405180910390fd5b610e2261189c565b610e2a6118da565b604080515f80825260208201909252600f60f81b9c939b5091995046985030975095509350915050565b5f610e5d6117ee565b61059883836118f0565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0480546060915f80516020612ae7833981519152916105c290612791565b5f33610662818585611548565b5f61064f8260016112c2565b5f610ec76117b7565b610ecf6117ee565b5f80516020612b478339815191525f80516020612ac78339815191525f610ef585611021565b905080871115610f1e57848782604051633fa733bb60e21b8152600401610e1193929190612810565b610f278761066c565b83549094505f90610f40908990610693816127106127c9565b9050610f4f3388888b8961190b565b80835f015f828254610f6191906127c9565b909155505060015f80516020612ba7833981519152555061059892505050565b5f610f8a6117b7565b610f926117ee565b5f80516020612ac78339815191525f610faa8461102e565b905080861115610fd357838682604051632e52afbb60e21b8152600401610e1193929190612810565b610fdc86610c18565b92505f610fe887610644565b90505f610ff585836127c9565b9050611004338888888c61190b565b80845f015f828254610f6191906127c9565b5f61064f825f61136e565b5f61064f61038a83610d27565b5f61064f82610d27565b5f80516020612b07833981519152545f80516020612b4783398151915290611089906001600160a01b03167fc67411bc4bac0146a9071ce6a755cb68b9cd48529376056bdce2c11ec1f572d5611470565b6109c48211156110ac57604051636b2f218360e01b815260040160405180910390fd5b8181556040518281527f9a1f74aeeb037eb3d45b22a56376dadd6ba6ded25ec3727e520415f6c76768a990602001610a85565b6001600160a01b039182165f9081527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace016020908152604080832093909416825291909152205490565b6001600160a01b03811661114f5760405163e99d5ac560e01b815260040160405180910390fd5b5f80516020612b07833981519152545f80516020612b47833981519152906111a0906001600160a01b03167f22435ed027edf5f902dc0093fbc24cdb50c05b5fd5f311b78c67c1cbaff60e13611470565b6001600160a01b0382165f90815260038201602052604090205460ff16156111db5760405163c23f6ccb60e01b815260040160405180910390fd5b6001600160a01b0382165f818152600383016020908152604091829020805460ff1916600117905590519182527f7811ed4e4b787e4f0f046ffb4a5ec1e064b0eb6d191ffabb66270ed8be89b3259101610a85565b7f9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc6547605545f905f80516020612ac78339815191529060ff16611271575f91505090565b80600401544211611283575f91505090565b5f61129242836003015461194e565b90505f8260040154826112a591906127c9565b90506112ba818460010154620151805f61132b565b935050505090565b5f6105986112ce610574565b6112d990600161277e565b6112e45f600a612911565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0254611310919061277e565b8591908561132b565b6113268383836001611963565b505050565b5f80611338868686611a47565b905061134383611b06565b801561135e57505f84806113595761135961291f565b868809115b156106b457610d0a60018261277e565b5f61059861137d82600a612911565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace02546113a9919061277e565b6113b1610574565b61131090600161277e565b6113c4611b32565b6113cd83611b7b565b6113d78282611b8c565b611326611b9e565b6113e7611b32565b5f80516020612b87833981519152805460ff19169055565b611407611b32565b61140f611bb8565b565b611419611b32565b5f80516020612b278339815191527fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d1026114528482612978565b50600381016114618382612978565b505f8082556001909101555050565b604051632474521560e21b8152600481018290523360248201526001600160a01b038316906391d1485490604401602060405180830381865afa1580156114b9573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114dd9190612a34565b6114fa5760405163ea8e4eb560e01b815260040160405180910390fd5b5050565b5f61150984846110df565b90505f198114610c12578181101561153a57828183604051637dc7a0d960e11b8152600401610e1193929190612810565b610c1284848484035f611963565b6001600160a01b03831661157157604051634b637e8f60e11b81525f6004820152602401610e11565b6001600160a01b03821661159a5760405163ec442f0560e01b81525f6004820152602401610e11565b611326838383611bc0565b6115ad611c56565b5f80516020612b87833981519152805460ff191681557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a150565b5f80516020612ac78339815191525f61161b610ae3565b9050845f0361163d57604051635b4193ff60e11b815260040160405180910390fd5b4284101561165e5760405163e9b6397160e01b815260040160405180910390fd5b83831161167e57604051630723f29360e31b815260040160405180910390fd5b81600301548410156116a35760405163c8a7453360e01b815260040160405180910390fd5b81600301544210156116c857604051633b6e614f60e21b815260040160405180910390fd5b6116d0611c85565b5f6116db85856127c9565b90505f6116ed8762015180845f61132b565b84549091506116fd90889061277e565b6040516370a0823160e01b81523060048201526001600160a01b038516906370a0823190602401602060405180830381865afa15801561173f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117639190612a53565b10156117825760405163b8b4fdc160e01b815260040160405180910390fd5b600180850191909155600284018690556003840194909455505060048101929092556005909101805460ff1916909117905550565b5f80516020612ba78339815191528054600119016117e857604051633ee5aeb560e01b815260040160405180910390fd5b60029055565b5f80516020612b878339815191525460ff161561140f5760405163d93c066560e01b815260040160405180910390fd5b60015f80516020612ba783398151915255565b5f5f195f61183e85611016565b905061184c33858784611d11565b949350505050565b61185c6117ee565b5f80516020612b87833981519152805460ff191660011781557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258336115e6565b7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d10280546060915f80516020612b27833981519152916105c290612791565b60605f5f80516020612b278339815191526105b1565b5f5f195f6118fd85610eb2565b905061184c33858388611d11565b5f80516020612ac7833981519152611921611c85565b82815f015f82825461193391906127c9565b9091555061194690508686868686611d51565b505050505050565b5f81831061195c5781610598565b5090919050565b5f80516020612ae78339815191526001600160a01b03851661199a5760405163e602df0560e01b81525f6004820152602401610e11565b6001600160a01b0384166119c357604051634a1406b160e11b81525f6004820152602401610e11565b6001600160a01b038086165f90815260018301602090815260408083209388168352929052208390558115611a4057836001600160a01b0316856001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92585604051611a3791815260200190565b60405180910390a35b5050505050565b5f838302815f1985870982811083820303915050805f03611a7b57838281611a7157611a7161291f565b0492505050610598565b808411611a9b5760405163227bc15360e01b815260040160405180910390fd5b5f848688095f868103871696879004966002600389028118808a02820302808a02820302808a02820302808a02820302808a02820302808a02909103029181900381900460010186841190950394909402919094039290920491909117919091029150509392505050565b5f6002826003811115611b1b57611b1b612a6a565b611b259190612a7e565b60ff166001149050919050565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff1661140f57604051631afcd79f60e31b815260040160405180910390fd5b611b83611b32565b610b3781611e05565b611b94611b32565b6114fa8282611e75565b611ba6611b32565b5f5f80516020612ac783398151915255565b61181e611b32565b6001600160a01b0383165f9081527fe34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b9679530360205260409020545f80516020612b478339815191529060ff1680611c2d57506001600160a01b0383165f90815260038201602052604090205460ff165b15611c4b576040516309550c7760e01b815260040160405180910390fd5b610c12848484611ec5565b5f80516020612b878339815191525460ff1661140f57604051638dfc202b60e01b815260040160405180910390fd5b7f9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc6547605545f80516020612ac78339815191529060ff16611cc05750565b5f611cc9611230565b905080825f015f828254611cdd919061277e565b92505081905550611cf242836003015461194e565b600483018190556003830154116114fa5750600501805460ff19169055565b5f80516020612ac7833981519152611d27611c85565b611d3385858585611feb565b82815f015f828254611d45919061277e565b90915550505050505050565b5f80516020612b678339815191526001600160a01b0386811690851614611d7d57611d7d8487846114fe565b611d878483612068565b8054611d9d906001600160a01b0316868561209c565b836001600160a01b0316856001600160a01b0316876001600160a01b03167ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db8686604051611df5929190918252602082015260400190565b60405180910390a4505050505050565b611e0d611b32565b5f80516020612b678339815191525f80611e26846120fb565b9150915081611e36576012611e38565b805b83546001600160a81b031916600160a01b60ff92909216919091026001600160a01b031916176001600160a01b0394909416939093179091555050565b611e7d611b32565b5f80516020612ae78339815191527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace03611eb68482612978565b5060048101610c128382612978565b5f80516020612ae78339815191526001600160a01b038416611eff5781816002015f828254611ef4919061277e565b90915550611f5c9050565b6001600160a01b0384165f9081526020829052604090205482811015611f3e5784818460405163391434e360e21b8152600401610e1193929190612810565b6001600160a01b0385165f9081526020839052604090209083900390555b6001600160a01b038316611f7a576002810180548390039055611f98565b6001600160a01b0383165f9081526020829052604090208054830190555b826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef84604051611fdd91815260200190565b60405180910390a350505050565b5f80516020612b678339815191528054612010906001600160a01b03168630866121d1565b61201a848361220a565b836001600160a01b0316856001600160a01b03167fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d78585604051611a37929190918252602082015260400190565b6001600160a01b03821661209157604051634b637e8f60e11b81525f6004820152602401610e11565b6114fa825f83611bc0565b6040516001600160a01b0383811660248301526044820183905261132691859182169063a9059cbb906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b03838183161783525050505061223e565b60408051600481526024810182526020810180516001600160e01b031663313ce56760e01b17905290515f918291829182916001600160a01b0387169161214191612aab565b5f60405180830381855afa9150503d805f8114612179576040519150601f19603f3d011682016040523d82523d5f602084013e61217e565b606091505b509150915081801561219257506020815110155b156121c5575f818060200190518101906121ac9190612a53565b905060ff81116121c3576001969095509350505050565b505b505f9485945092505050565b6040516001600160a01b038481166024830152838116604483015260648201839052610c129186918216906323b872dd906084016120c9565b6001600160a01b0382166122335760405163ec442f0560e01b81525f6004820152602401610e11565b6114fa5f8383611bc0565b5f6122526001600160a01b0384168361229f565b905080515f141580156122765750808060200190518101906122749190612a34565b155b1561132657604051635274afe760e01b81526001600160a01b0384166004820152602401610e11565b606061059883835f845f80856001600160a01b031684866040516122c39190612aab565b5f6040518083038185875af1925050503d805f81146122fd576040519150601f19603f3d011682016040523d82523d5f602084013e612302565b606091505b5091509150610d0a8683836060826123225761231d82612369565b610598565b815115801561233957506001600160a01b0384163b155b1561236257604051639996b31560e01b81526001600160a01b0385166004820152602401610e11565b5080610598565b8051156123795780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b5f5b838110156123ac578181015183820152602001612394565b50505f910152565b5f81518084526123cb816020860160208601612392565b601f01601f19169290920160200192915050565b602081525f61059860208301846123b4565b5f60208284031215612401575f80fd5b5035919050565b6001600160a01b0381168114610b37575f80fd5b5f806040838503121561242d575f80fd5b823561243881612408565b946020939093013593505050565b634e487b7160e01b5f52604160045260245ffd5b5f82601f830112612469575f80fd5b813567ffffffffffffffff8082111561248457612484612446565b604051601f8301601f19908116603f011681019082821181831017156124ac576124ac612446565b816040528381528660208588010111156124c4575f80fd5b836020870160208301375f602085830101528094505050505092915050565b5f805f80608085870312156124f6575f80fd5b843561250181612408565b935060208501359250604085013567ffffffffffffffff80821115612524575f80fd5b6125308883890161245a565b93506060870135915080821115612545575f80fd5b506125528782880161245a565b91505092959194509250565b5f6020828403121561256e575f80fd5b813561059881612408565b5f805f6060848603121561258b575f80fd5b833561259681612408565b925060208401356125a681612408565b929592945050506040919091013590565b5f805f606084860312156125c9575f80fd5b505081359360208301359350604090920135919050565b5f805f805f8060c087890312156125f5575f80fd5b86359550602087013561260781612408565b945060408701359350606087013560ff81168114612623575f80fd5b9598949750929560808101359460a0909101359350915050565b5f806040838503121561264e575f80fd5b82359150602083013561266081612408565b809150509250929050565b60ff60f81b881681525f602060e08184015261268a60e084018a6123b4565b838103604085015261269c818a6123b4565b606085018990526001600160a01b038816608086015260a0850187905284810360c086015285518082528387019250908301905f5b818110156126ed578351835292840192918401916001016126d1565b50909c9b505050505050505050505050565b5f805f60608486031215612711575f80fd5b83359250602084013561272381612408565b9150604084013561273381612408565b809150509250925092565b5f806040838503121561274f575f80fd5b823561275a81612408565b9150602083013561266081612408565b634e487b7160e01b5f52601160045260245ffd5b8082018082111561064f5761064f61276a565b600181811c908216806127a557607f821691505b6020821081036127c357634e487b7160e01b5f52602260045260245ffd5b50919050565b8181038181111561064f5761064f61276a565b5f602082840312156127ec575f80fd5b815161059881612408565b60ff818116838216019081111561064f5761064f61276a565b6001600160a01b039390931683526020830191909152604082015260600190565b600181815b8085111561286b57815f19048211156128515761285161276a565b8085161561285e57918102915b93841c9390800290612836565b509250929050565b5f826128815750600161064f565b8161288d57505f61064f565b81600181146128a357600281146128ad576128c9565b600191505061064f565b60ff8411156128be576128be61276a565b50506001821b61064f565b5060208310610133831016604e8410600b84101617156128ec575081810a61064f565b6128f68383612831565b805f19048211156129095761290961276a565b029392505050565b5f61059860ff841683612873565b634e487b7160e01b5f52601260045260245ffd5b601f821115611326575f81815260208120601f850160051c810160208610156129595750805b601f850160051c820191505b8181101561194657828155600101612965565b815167ffffffffffffffff81111561299257612992612446565b6129a6816129a08454612791565b84612933565b602080601f8311600181146129d9575f84156129c25750858301515b5f19600386901b1c1916600185901b178555611946565b5f85815260208120601f198616915b82811015612a07578886015182559484019460019091019084016129e8565b5085821015612a2457878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b5f60208284031215612a44575f80fd5b81518015158114610598575f80fd5b5f60208284031215612a63575f80fd5b5051919050565b634e487b7160e01b5f52602160045260245ffd5b5f60ff831680612a9c57634e487b7160e01b5f52601260045260245ffd5b8060ff84160691505092915050565b5f8251612abc818460208701612392565b919091019291505056fe9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc654760052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00e34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b96795301a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100e34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b967953000773e532dfede91f04b12a73d3d2acd361424f41f76b4fb79f090161e36b4e00cd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f033009b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00a2646970667358221220f1683bdccbee3dea4084b020edd5d4382edf284eea4ca4c26e89912586e39eae64736f6c63430008140033
Deployed Bytecode
0x608060405234801561000f575f80fd5b5060043610610234575f3560e01c806370a0823111610135578063c63d75b6116100b4578063dd62ed3e11610079578063dd62ed3e146104dd578063ef8b30f714610491578063f1009899146104f0578063f9f92be414610517578063fe575a871461052a575f80fd5b8063c63d75b614610355578063c6e6f59214610491578063ce96cb77146104a4578063d905777e146104b7578063daf635de146104ca575f80fd5b806395d89b41116100fa57806395d89b411461043d578063a9059cbb14610445578063b3d7f6b914610458578063b460af941461046b578063ba0876521461047e575f80fd5b806370a08231146103e05780637aca2b59146103f35780638456cb591461040757806384b0196e1461040f57806394bf804d1461042a575f80fd5b8063313ce567116101c15780634cdad506116101865780634cdad5061461037c57806350921b231461038f57806353428e01146103a25780635c975abb146103b65780636e553f65146103cd575f80fd5b8063313ce5671461031357806338d52e0f1461032d5780633f4ba83a1461034d578063402d267d1461035557806348678c2314610369575f80fd5b80630a28a477116102075780630a28a4771461029e578063148f51f3146102b157806318160ddd146102c65780631a895266146102ed57806323b872dd14610300575f80fd5b806301e1d1141461023857806306fdde031461025357806307a2d13a14610268578063095ea7b31461027b575b5f80fd5b610240610574565b6040519081526020015b60405180910390f35b61025b61059f565b60405161024a91906123df565b6102406102763660046123f1565b610644565b61028e61028936600461241c565b610655565b604051901515815260200161024a565b6102406102ac3660046123f1565b61066c565b6102c46102bf3660046124e3565b6106bd565b005b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0254610240565b6102c46102fb36600461255e565b6109ac565b61028e61030e366004612579565b610a91565b61031b610ab4565b60405160ff909116815260200161024a565b610335610ae3565b6040516001600160a01b03909116815260200161024a565b6102c4610afe565b61024061036336600461255e565b505f1990565b6102c46103773660046125b7565b610b3a565b61024061038a3660046123f1565b610c18565b61024061039d3660046125e0565b610c52565b6102405f80516020612b4783398151915281565b5f80516020612b878339815191525460ff1661028e565b6102406103db36600461263d565b610d14565b6102406103ee36600461255e565b610d27565b5f80516020612b4783398151915254610240565b6102c4610d4d565b610417610da6565b60405161024a979695949392919061266b565b61024061043836600461263d565b610e54565b61025b610e67565b61028e61045336600461241c565b610ea5565b6102406104663660046123f1565b610eb2565b6102406104793660046126ff565b610ebe565b61024061048c3660046126ff565b610f81565b61024061049f3660046123f1565b611016565b6102406104b236600461255e565b611021565b6102406104c536600461255e565b61102e565b6102c46104d83660046123f1565b611038565b6102406104eb36600461273e565b6110df565b7f9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc654760154610240565b6102c461052536600461255e565b611128565b61028e61053836600461255e565b6001600160a01b03165f9081527fe34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b96795303602052604090205460ff1690565b5f5f80516020612ac78339815191528161058c611230565b8254610598919061277e565b9392505050565b60605f5f80516020612ae78339815191525b90508060030180546105c290612791565b80601f01602080910402602001604051908101604052809291908181526020018280546105ee90612791565b80156106395780601f1061061057610100808354040283529160200191610639565b820191905f5260205f20905b81548152906001019060200180831161061c57829003601f168201915b505050505091505090565b5f61064f825f6112c2565b92915050565b5f33610662818585611319565b5060019392505050565b5f80516020612b4783398151915280545f9190829061069a908590610693816127106127c9565b600161132b565b90505f6106a7828661277e565b90506106b481600161136e565b95945050505050565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a008054600160401b810460ff16159067ffffffffffffffff165f811580156107025750825b90505f8267ffffffffffffffff16600114801561071e5750303b155b90508115801561072c575080155b1561074a5760405163f92ee8a960e01b815260040160405180910390fd5b845467ffffffffffffffff19166001178555831561077457845460ff60401b1916600160401b1785555b6001600160a01b03891661079b576040516307988a3f60e21b815260040160405180910390fd5b5f5f80516020612b478339815191526002810180546001600160a01b0319166001600160a01b038d16908117909155604051631c2d8fb360e31b81527fdbbc50039ed3ca50ec88fa75d6fe32dae25b22535afc1cd51cf4090d5ebc4d2860048201529192505f9163e16c7d9890602401602060405180830381865afa158015610826573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061084a91906127dc565b9050610857818a8a6113bc565b61085f6113df565b6108676113ff565b61088a89604051806040016040528060018152602001603160f81b815250611411565b6109c48a11156108ad57604051636b2f218360e01b815260040160405180910390fd5b898255604051631c2d8fb360e31b81527f5a92fc7720b8c2c63ba7a9aec6e2269feb0e8c23b216e4162abc2b6ed5e5a22b60048201526001600160a01b038c169063e16c7d9890602401602060405180830381865afa158015610912573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061093691906127dc565b60019290920180546001600160a01b0319166001600160a01b03909316929092179091555083156109a157845460ff60401b19168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b505050505050505050565b5f80516020612b07833981519152545f80516020612b47833981519152906109fd906001600160a01b03167f22435ed027edf5f902dc0093fbc24cdb50c05b5fd5f311b78c67c1cbaff60e13611470565b6001600160a01b0382165f90815260038201602052604090205460ff16610a375760405163c23f6ccb60e01b815260040160405180910390fd5b6001600160a01b0382165f818152600383016020908152604091829020805460ff1916905590519182527fc653d95790bb2472667b557ef27642a37cac57b69d6d5fddcaacef8f62589dcb91015b60405180910390a15050565b5f33610a9e8582856114fe565b610aa9858585611548565b506001949350505050565b5f805f80516020612b6783398151915290505f8154610add9190600160a01b900460ff166127f7565b91505090565b5f80516020612b67833981519152546001600160a01b031690565b5f80516020612b07833981519152545f80516020612b4783398151915290610b2f906001600160a01b03165f611470565b610b376115a5565b50565b5f5f80516020612b478339815191526002810154604051631c2d8fb360e31b81527fb221b00ba6c9ff59b4362c86e96b2b0d48eccfb80034a35cfd29acf81707947d60048201529192506001600160a01b03169063e16c7d9890602401602060405180830381865afa158015610bb2573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610bd691906127dc565b6001600160a01b0316336001600160a01b031614610c075760405163ea8e4eb560e01b815260040160405180910390fd5b610c12848484611604565b50505050565b5f5f80516020612b4783398151915281610c3184610644565b90505f610c4682845f0154612710600161132b565b90506106b481836127c9565b5f610c5b6117b7565b610c636117ee565b610c6b610ae3565b60405163d505accf60e01b8152336004820152306024820152604481018990526064810187905260ff8616608482015260a4810185905260c481018490526001600160a01b03919091169063d505accf9060e4015f604051808303815f87803b158015610cd6575f80fd5b505af1925050508015610ce7575060015b50610cf28787610d14565b9050610d0a60015f80516020612ba783398151915255565b9695505050505050565b5f610d1d6117ee565b6105988383611831565b6001600160a01b03165f9081525f80516020612ae7833981519152602052604090205490565b5f80516020612b07833981519152545f80516020612b4783398151915290610d9e906001600160a01b03167fe40ef4c9f0881870a532466eceeb9426f92f3b4563aab91fc873619411dc7014611470565b610b37611854565b5f60608082808083815f80516020612b278339815191528054909150158015610dd157506001810154155b610e1a5760405162461bcd60e51b81526020600482015260156024820152741152540dcc4c8e88155b9a5b9a5d1a585b1a5e9959605a1b60448201526064015b60405180910390fd5b610e2261189c565b610e2a6118da565b604080515f80825260208201909252600f60f81b9c939b5091995046985030975095509350915050565b5f610e5d6117ee565b61059883836118f0565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0480546060915f80516020612ae7833981519152916105c290612791565b5f33610662818585611548565b5f61064f8260016112c2565b5f610ec76117b7565b610ecf6117ee565b5f80516020612b478339815191525f80516020612ac78339815191525f610ef585611021565b905080871115610f1e57848782604051633fa733bb60e21b8152600401610e1193929190612810565b610f278761066c565b83549094505f90610f40908990610693816127106127c9565b9050610f4f3388888b8961190b565b80835f015f828254610f6191906127c9565b909155505060015f80516020612ba7833981519152555061059892505050565b5f610f8a6117b7565b610f926117ee565b5f80516020612ac78339815191525f610faa8461102e565b905080861115610fd357838682604051632e52afbb60e21b8152600401610e1193929190612810565b610fdc86610c18565b92505f610fe887610644565b90505f610ff585836127c9565b9050611004338888888c61190b565b80845f015f828254610f6191906127c9565b5f61064f825f61136e565b5f61064f61038a83610d27565b5f61064f82610d27565b5f80516020612b07833981519152545f80516020612b4783398151915290611089906001600160a01b03167fc67411bc4bac0146a9071ce6a755cb68b9cd48529376056bdce2c11ec1f572d5611470565b6109c48211156110ac57604051636b2f218360e01b815260040160405180910390fd5b8181556040518281527f9a1f74aeeb037eb3d45b22a56376dadd6ba6ded25ec3727e520415f6c76768a990602001610a85565b6001600160a01b039182165f9081527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace016020908152604080832093909416825291909152205490565b6001600160a01b03811661114f5760405163e99d5ac560e01b815260040160405180910390fd5b5f80516020612b07833981519152545f80516020612b47833981519152906111a0906001600160a01b03167f22435ed027edf5f902dc0093fbc24cdb50c05b5fd5f311b78c67c1cbaff60e13611470565b6001600160a01b0382165f90815260038201602052604090205460ff16156111db5760405163c23f6ccb60e01b815260040160405180910390fd5b6001600160a01b0382165f818152600383016020908152604091829020805460ff1916600117905590519182527f7811ed4e4b787e4f0f046ffb4a5ec1e064b0eb6d191ffabb66270ed8be89b3259101610a85565b7f9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc6547605545f905f80516020612ac78339815191529060ff16611271575f91505090565b80600401544211611283575f91505090565b5f61129242836003015461194e565b90505f8260040154826112a591906127c9565b90506112ba818460010154620151805f61132b565b935050505090565b5f6105986112ce610574565b6112d990600161277e565b6112e45f600a612911565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0254611310919061277e565b8591908561132b565b6113268383836001611963565b505050565b5f80611338868686611a47565b905061134383611b06565b801561135e57505f84806113595761135961291f565b868809115b156106b457610d0a60018261277e565b5f61059861137d82600a612911565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace02546113a9919061277e565b6113b1610574565b61131090600161277e565b6113c4611b32565b6113cd83611b7b565b6113d78282611b8c565b611326611b9e565b6113e7611b32565b5f80516020612b87833981519152805460ff19169055565b611407611b32565b61140f611bb8565b565b611419611b32565b5f80516020612b278339815191527fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d1026114528482612978565b50600381016114618382612978565b505f8082556001909101555050565b604051632474521560e21b8152600481018290523360248201526001600160a01b038316906391d1485490604401602060405180830381865afa1580156114b9573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114dd9190612a34565b6114fa5760405163ea8e4eb560e01b815260040160405180910390fd5b5050565b5f61150984846110df565b90505f198114610c12578181101561153a57828183604051637dc7a0d960e11b8152600401610e1193929190612810565b610c1284848484035f611963565b6001600160a01b03831661157157604051634b637e8f60e11b81525f6004820152602401610e11565b6001600160a01b03821661159a5760405163ec442f0560e01b81525f6004820152602401610e11565b611326838383611bc0565b6115ad611c56565b5f80516020612b87833981519152805460ff191681557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a150565b5f80516020612ac78339815191525f61161b610ae3565b9050845f0361163d57604051635b4193ff60e11b815260040160405180910390fd5b4284101561165e5760405163e9b6397160e01b815260040160405180910390fd5b83831161167e57604051630723f29360e31b815260040160405180910390fd5b81600301548410156116a35760405163c8a7453360e01b815260040160405180910390fd5b81600301544210156116c857604051633b6e614f60e21b815260040160405180910390fd5b6116d0611c85565b5f6116db85856127c9565b90505f6116ed8762015180845f61132b565b84549091506116fd90889061277e565b6040516370a0823160e01b81523060048201526001600160a01b038516906370a0823190602401602060405180830381865afa15801561173f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906117639190612a53565b10156117825760405163b8b4fdc160e01b815260040160405180910390fd5b600180850191909155600284018690556003840194909455505060048101929092556005909101805460ff1916909117905550565b5f80516020612ba78339815191528054600119016117e857604051633ee5aeb560e01b815260040160405180910390fd5b60029055565b5f80516020612b878339815191525460ff161561140f5760405163d93c066560e01b815260040160405180910390fd5b60015f80516020612ba783398151915255565b5f5f195f61183e85611016565b905061184c33858784611d11565b949350505050565b61185c6117ee565b5f80516020612b87833981519152805460ff191660011781557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258336115e6565b7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d10280546060915f80516020612b27833981519152916105c290612791565b60605f5f80516020612b278339815191526105b1565b5f5f195f6118fd85610eb2565b905061184c33858388611d11565b5f80516020612ac7833981519152611921611c85565b82815f015f82825461193391906127c9565b9091555061194690508686868686611d51565b505050505050565b5f81831061195c5781610598565b5090919050565b5f80516020612ae78339815191526001600160a01b03851661199a5760405163e602df0560e01b81525f6004820152602401610e11565b6001600160a01b0384166119c357604051634a1406b160e11b81525f6004820152602401610e11565b6001600160a01b038086165f90815260018301602090815260408083209388168352929052208390558115611a4057836001600160a01b0316856001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92585604051611a3791815260200190565b60405180910390a35b5050505050565b5f838302815f1985870982811083820303915050805f03611a7b57838281611a7157611a7161291f565b0492505050610598565b808411611a9b5760405163227bc15360e01b815260040160405180910390fd5b5f848688095f868103871696879004966002600389028118808a02820302808a02820302808a02820302808a02820302808a02820302808a02909103029181900381900460010186841190950394909402919094039290920491909117919091029150509392505050565b5f6002826003811115611b1b57611b1b612a6a565b611b259190612a7e565b60ff166001149050919050565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a0054600160401b900460ff1661140f57604051631afcd79f60e31b815260040160405180910390fd5b611b83611b32565b610b3781611e05565b611b94611b32565b6114fa8282611e75565b611ba6611b32565b5f5f80516020612ac783398151915255565b61181e611b32565b6001600160a01b0383165f9081527fe34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b9679530360205260409020545f80516020612b478339815191529060ff1680611c2d57506001600160a01b0383165f90815260038201602052604090205460ff165b15611c4b576040516309550c7760e01b815260040160405180910390fd5b610c12848484611ec5565b5f80516020612b878339815191525460ff1661140f57604051638dfc202b60e01b815260040160405180910390fd5b7f9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc6547605545f80516020612ac78339815191529060ff16611cc05750565b5f611cc9611230565b905080825f015f828254611cdd919061277e565b92505081905550611cf242836003015461194e565b600483018190556003830154116114fa5750600501805460ff19169055565b5f80516020612ac7833981519152611d27611c85565b611d3385858585611feb565b82815f015f828254611d45919061277e565b90915550505050505050565b5f80516020612b678339815191526001600160a01b0386811690851614611d7d57611d7d8487846114fe565b611d878483612068565b8054611d9d906001600160a01b0316868561209c565b836001600160a01b0316856001600160a01b0316876001600160a01b03167ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db8686604051611df5929190918252602082015260400190565b60405180910390a4505050505050565b611e0d611b32565b5f80516020612b678339815191525f80611e26846120fb565b9150915081611e36576012611e38565b805b83546001600160a81b031916600160a01b60ff92909216919091026001600160a01b031916176001600160a01b0394909416939093179091555050565b611e7d611b32565b5f80516020612ae78339815191527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace03611eb68482612978565b5060048101610c128382612978565b5f80516020612ae78339815191526001600160a01b038416611eff5781816002015f828254611ef4919061277e565b90915550611f5c9050565b6001600160a01b0384165f9081526020829052604090205482811015611f3e5784818460405163391434e360e21b8152600401610e1193929190612810565b6001600160a01b0385165f9081526020839052604090209083900390555b6001600160a01b038316611f7a576002810180548390039055611f98565b6001600160a01b0383165f9081526020829052604090208054830190555b826001600160a01b0316846001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef84604051611fdd91815260200190565b60405180910390a350505050565b5f80516020612b678339815191528054612010906001600160a01b03168630866121d1565b61201a848361220a565b836001600160a01b0316856001600160a01b03167fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d78585604051611a37929190918252602082015260400190565b6001600160a01b03821661209157604051634b637e8f60e11b81525f6004820152602401610e11565b6114fa825f83611bc0565b6040516001600160a01b0383811660248301526044820183905261132691859182169063a9059cbb906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b03838183161783525050505061223e565b60408051600481526024810182526020810180516001600160e01b031663313ce56760e01b17905290515f918291829182916001600160a01b0387169161214191612aab565b5f60405180830381855afa9150503d805f8114612179576040519150601f19603f3d011682016040523d82523d5f602084013e61217e565b606091505b509150915081801561219257506020815110155b156121c5575f818060200190518101906121ac9190612a53565b905060ff81116121c3576001969095509350505050565b505b505f9485945092505050565b6040516001600160a01b038481166024830152838116604483015260648201839052610c129186918216906323b872dd906084016120c9565b6001600160a01b0382166122335760405163ec442f0560e01b81525f6004820152602401610e11565b6114fa5f8383611bc0565b5f6122526001600160a01b0384168361229f565b905080515f141580156122765750808060200190518101906122749190612a34565b155b1561132657604051635274afe760e01b81526001600160a01b0384166004820152602401610e11565b606061059883835f845f80856001600160a01b031684866040516122c39190612aab565b5f6040518083038185875af1925050503d805f81146122fd576040519150601f19603f3d011682016040523d82523d5f602084013e612302565b606091505b5091509150610d0a8683836060826123225761231d82612369565b610598565b815115801561233957506001600160a01b0384163b155b1561236257604051639996b31560e01b81526001600160a01b0385166004820152602401610e11565b5080610598565b8051156123795780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b5f5b838110156123ac578181015183820152602001612394565b50505f910152565b5f81518084526123cb816020860160208601612392565b601f01601f19169290920160200192915050565b602081525f61059860208301846123b4565b5f60208284031215612401575f80fd5b5035919050565b6001600160a01b0381168114610b37575f80fd5b5f806040838503121561242d575f80fd5b823561243881612408565b946020939093013593505050565b634e487b7160e01b5f52604160045260245ffd5b5f82601f830112612469575f80fd5b813567ffffffffffffffff8082111561248457612484612446565b604051601f8301601f19908116603f011681019082821181831017156124ac576124ac612446565b816040528381528660208588010111156124c4575f80fd5b836020870160208301375f602085830101528094505050505092915050565b5f805f80608085870312156124f6575f80fd5b843561250181612408565b935060208501359250604085013567ffffffffffffffff80821115612524575f80fd5b6125308883890161245a565b93506060870135915080821115612545575f80fd5b506125528782880161245a565b91505092959194509250565b5f6020828403121561256e575f80fd5b813561059881612408565b5f805f6060848603121561258b575f80fd5b833561259681612408565b925060208401356125a681612408565b929592945050506040919091013590565b5f805f606084860312156125c9575f80fd5b505081359360208301359350604090920135919050565b5f805f805f8060c087890312156125f5575f80fd5b86359550602087013561260781612408565b945060408701359350606087013560ff81168114612623575f80fd5b9598949750929560808101359460a0909101359350915050565b5f806040838503121561264e575f80fd5b82359150602083013561266081612408565b809150509250929050565b60ff60f81b881681525f602060e08184015261268a60e084018a6123b4565b838103604085015261269c818a6123b4565b606085018990526001600160a01b038816608086015260a0850187905284810360c086015285518082528387019250908301905f5b818110156126ed578351835292840192918401916001016126d1565b50909c9b505050505050505050505050565b5f805f60608486031215612711575f80fd5b83359250602084013561272381612408565b9150604084013561273381612408565b809150509250925092565b5f806040838503121561274f575f80fd5b823561275a81612408565b9150602083013561266081612408565b634e487b7160e01b5f52601160045260245ffd5b8082018082111561064f5761064f61276a565b600181811c908216806127a557607f821691505b6020821081036127c357634e487b7160e01b5f52602260045260245ffd5b50919050565b8181038181111561064f5761064f61276a565b5f602082840312156127ec575f80fd5b815161059881612408565b60ff818116838216019081111561064f5761064f61276a565b6001600160a01b039390931683526020830191909152604082015260600190565b600181815b8085111561286b57815f19048211156128515761285161276a565b8085161561285e57918102915b93841c9390800290612836565b509250929050565b5f826128815750600161064f565b8161288d57505f61064f565b81600181146128a357600281146128ad576128c9565b600191505061064f565b60ff8411156128be576128be61276a565b50506001821b61064f565b5060208310610133831016604e8410600b84101617156128ec575081810a61064f565b6128f68383612831565b805f19048211156129095761290961276a565b029392505050565b5f61059860ff841683612873565b634e487b7160e01b5f52601260045260245ffd5b601f821115611326575f81815260208120601f850160051c810160208610156129595750805b601f850160051c820191505b8181101561194657828155600101612965565b815167ffffffffffffffff81111561299257612992612446565b6129a6816129a08454612791565b84612933565b602080601f8311600181146129d9575f84156129c25750858301515b5f19600386901b1c1916600185901b178555611946565b5f85815260208120601f198616915b82811015612a07578886015182559484019460019091019084016129e8565b5085821015612a2457878501515f19600388901b60f8161c191681555b5050505050600190811b01905550565b5f60208284031215612a44575f80fd5b81518015158114610598575f80fd5b5f60208284031215612a63575f80fd5b5051919050565b634e487b7160e01b5f52602160045260245ffd5b5f60ff831680612a9c57634e487b7160e01b5f52601260045260245ffd5b8060ff84160691505092915050565b5f8251612abc818460208701612392565b919091019291505056fe9a66cc64068466ca9954f77b424b83884332fd82446a2cbd356234cdc654760052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00e34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b96795301a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100e34b7e189bdc1dc8307eb679fcc632f366df79571fb57039f593735b967953000773e532dfede91f04b12a73d3d2acd361424f41f76b4fb79f090161e36b4e00cd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f033009b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00a2646970667358221220f1683bdccbee3dea4084b020edd5d4382edf284eea4ca4c26e89912586e39eae64736f6c63430008140033
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 30 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
Loading...
Loading
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.