// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.29;

import { SingleStrategyVault, IERC20, IController, IERC4626 } from "./SingleStrategyVault.sol";

/**
 * @title GenericVault
 * @notice A vault that utilizes a single strategy for asset management.
 * @dev Inherits from SingleStrategyVault to provide core vault functionalities.
 */
contract GenericVault is SingleStrategyVault {
    string public constant VERSION = "1.0";

    constructor(
        IERC20 asset_,
        IController controller_,
        IERC4626 strategy_,
        address manager_
    )
        SingleStrategyVault(asset_, controller_, strategy_, manager_)
    { }
}

// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.29;

import { IERC4626 } from "@openzeppelin/contracts/interfaces/IERC4626.sol";

import { ControlledERC7575Vault, SafeERC20, IERC20, IController } from "./ControlledERC7575Vault.sol";

/**
 * @title SingleStrategyVault
 * @notice A vault implementation that manages assets by depositing into a single ERC4626 vault
 * @dev Extends ControlledERC7575Vault to provide automated allocation/deallocation functionality
 * The vault automatically allocates assets to the strategy when deposits exceed the threshold
 * and deallocates assets when withdrawals require more than the available unallocated balance
 */
contract SingleStrategyVault is ControlledERC7575Vault {
    /**
     * @notice The ERC4626 vault used for yield generation
     */
    IERC4626 private immutable _strategy;
    /**
     * @notice The address authorized to manage allocations and vault parameters
     */
    address private immutable _manager;

    /**
     * @notice The minimum amount of assets that triggers automatic allocation to the strategy
     */
    uint256 public autoAllocationThreshold;

    /**
     * @notice Emitted when assets are allocated to the strategy
     */
    event Allocate(address strategy, uint256 assets);
    /**
     * @notice Emitted when assets are deallocated from the strategy
     */
    event Deallocate(address strategy, uint256 assets);
    /**
     * @notice Emitted when the auto-allocation threshold is updated
     */
    event SetAutoAllocationThreshold(uint256 threshold);

    /**
     * @notice Thrown when the strategy address is zero
     */
    error ZeroStrategy();
    /**
     * @notice Thrown when the strategy's asset does not match the vault's asset
     */
    error MismatchedAsset();
    /**
     * @notice Thrown when caller is not the authorized manager
     */
    error CallerNotManager();

    /**
     * @notice Constructs a new SingleStrategyVault
     * @dev Approves the strategy to spend unlimited vault assets for efficient deposits.
     * Manager can be zero address, in which case manual allocation/deallocation and threshold setting are disabled.
     * All deposits are automatically deployed to the strategy as default autoAllocationThreshold is zero.
     *
     * Requirements:
     * - `strategy_` must not be the zero address
     * - `asset_` and `controller_` must satisfy ControlledERC7575Vault requirements
     *
     * @param asset_ The underlying ERC20 asset that the vault accepts
     * @param controller_ The controller contract that governs this vault
     * @param strategy_ The ERC4626 vault for yield generation (cannot be zero address)
     * @param manager_ The address authorized to manage vault operations.
     */
    constructor(
        IERC20 asset_,
        IController controller_,
        IERC4626 strategy_,
        address manager_
    )
        ControlledERC7575Vault(asset_, controller_)
    {
        require(address(strategy_) != address(0), ZeroStrategy());
        require(strategy_.asset() == address(asset_), MismatchedAsset());

        _strategy = strategy_;
        _manager = manager_;

        SafeERC20.forceApprove(_asset, address(_strategy), type(uint256).max);
    }

    /**
     * @notice Returns the address of the underlying ERC4626 vault
     * @return The address of the strategy contract
     */
    function strategy() external view returns (address) {
        return address(_strategy);
    }

    /**
     * @notice Returns the address of the vault manager
     * @return The address authorized to manage vault operations
     */
    function manager() external view returns (address) {
        return _manager;
    }

    /**
     * @notice Manually allocates vault assets to the underlying strategy
     * @dev Only callable by the manager. Deposits assets into the strategy and receives strategy shares
     * @param assets The amount of assets to allocate to the strategy
     * @return shares The number of strategy shares received in return
     */
    function allocate(uint256 assets) external returns (uint256 shares) {
        require(msg.sender == _manager, CallerNotManager());
        return _allocate(assets);
    }

    /**
     * @notice Manually deallocates assets from the underlying strategy
     * @dev Only callable by the manager. Withdraws assets from the strategy back to the vault
     * @param assets The amount of assets to withdraw from the strategy
     * @return shares The number of strategy shares burned in the process
     */
    function deallocate(uint256 assets) external returns (uint256 shares) {
        require(msg.sender == _manager, CallerNotManager());
        return _deallocate(assets);
    }

    /**
     * @notice Sets the threshold for automatic allocation of deposited assets
     * @dev Only callable by the manager. When deposits exceed this threshold,
     * assets are automatically allocated to the strategy
     * @param threshold The minimum deposit amount that triggers automatic allocation
     */
    function setAutoAllocationThreshold(uint256 threshold) external {
        require(msg.sender == _manager, CallerNotManager());
        autoAllocationThreshold = threshold;
        emit SetAutoAllocationThreshold(threshold);
    }

    /**
     * @notice Internal function to allocate assets to the strategy
     * @dev Deposits assets into the strategy and emits an Allocate event
     * @param assets The amount of assets to deposit into the strategy
     * @return shares The number of strategy shares received
     */
    function _allocate(uint256 assets) private returns (uint256 shares) {
        shares = _strategy.deposit(assets, address(this));
        emit Allocate(address(_strategy), assets);
    }

    /**
     * @notice Internal function to deallocate assets from the strategy
     * @dev Withdraws assets from the strategy to this vault and emits a Deallocate event
     * @param assets The amount of assets to withdraw from the strategy
     * @return shares The number of strategy shares burned
     */
    function _deallocate(uint256 assets) private returns (uint256 shares) {
        shares = _strategy.withdraw(assets, address(this), address(this));
        emit Deallocate(address(_strategy), assets);
    }

    /**
     * @notice Calculates assets owned by the vault but not held directly in the vault
     * @dev Override from ControlledERC7575Vault. Returns only assets allocated to strategies,
     * not including assets held directly in the vault. Converts strategy shares to underlying asset value.
     * @return The amount of underlying assets owned through strategy allocation (excluding vault balance)
     */
    function _additionalOwnedAssets() internal view override returns (uint256) {
        return _strategy.convertToAssets(_strategy.balanceOf(address(this)));
    }

    /**
     * @notice Calculates the maximum assets immediately available for withdrawal
     * @dev Override from ControlledERC7575Vault to include strategy liquidity
     * @return The amount of assets that can be withdrawn without waiting
     */
    function _additionalAvailableAssets() internal view override returns (uint256) {
        return _strategy.maxWithdraw(address(this));
    }

    /**
     * @notice Hook executed before processing withdrawals to ensure sufficient liquidity
     * @dev Override from ControlledERC7575Vault. Automatically deallocates from strategy if needed
     * @param assets The amount of assets being withdrawn
     */
    function _beforeWithdraw(uint256 assets) internal override {
        uint256 unallocated = _asset.balanceOf(address(this));
        if (assets > unallocated) {
            _deallocate(assets - unallocated);
        }
    }

    /**
     * @notice Hook executed after processing deposits to potentially auto-allocate assets
     * @dev Override from ControlledERC7575Vault. Automatically allocates to strategy if deposit exceeds threshold
     * @param assets The amount of assets that were deposited
     */
    function _afterDeposit(uint256 assets) internal override {
        if (assets >= autoAllocationThreshold) {
            _allocate(assets);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC4626.sol)

pragma solidity >=0.6.2;

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

/**
 * @dev Interface of the ERC-4626 "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 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) 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: BUSL-1.1
pragma solidity 0.8.29;

import { IERC20 } from "@openzeppelin/contracts/interfaces/IERC20.sol";
import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import { Math } from "@openzeppelin/contracts/utils/math/Math.sol";
import { ReentrancyGuardTransient } from "@openzeppelin/contracts/utils/ReentrancyGuardTransient.sol";

import { IControlledVault } from "../interfaces/IControlledVault.sol";
import { IController } from "../interfaces/IController.sol";
import { IERC7575Vault } from "../interfaces/IERC7575Vault.sol";
import { tryGetAssetDecimals } from "../utils/tryGetAssetDecimals.sol";

/**
 * @title ControlledERC7575Vault
 * @notice A base vault implementation that conforms to ERC7575 standards and can be managed by a controller
 * @dev This contract serves as the foundation for individual asset vaults in the ecosystem.
 * It handles decimal normalization, controller integration, and implements the core ERC7575 vault operations.
 * The vault automatically normalizes all asset amounts to 18 decimals for consistent cross-vault calculations,
 * regardless of the underlying asset's actual decimal places.
 *
 * Key Features:
 * - ERC7575 compliant vault operations (deposit, mint, withdraw, redeem)
 * - Automatic decimal normalization to 18 decimals
 * - Controller-managed rebalancing capabilities
 * - Extensible hooks for custom vault implementations
 * - Safe asset transfers using OpenZeppelin's SafeERC20
 */
contract ControlledERC7575Vault is ReentrancyGuardTransient, IERC7575Vault, IControlledVault {
    using SafeERC20 for IERC20;

    /**
     * @notice The standardized decimal precision used for all normalized asset calculations
     */
    uint8 public constant NORMALIZED_ASSET_DECIMALS = 18;

    /**
     * @notice The underlying ERC20 asset managed by this vault
     */
    IERC20 internal immutable _asset;
    /**
     * @notice The controller contract that manages this vault
     */
    IController internal immutable _controller;
    /**
     * @notice The decimal offset used to normalize asset amounts to 18 decimals
     */
    uint8 internal immutable _decimalsOffset;

    /**
     * @notice Thrown when attempting to create a vault with a zero address asset
     */
    error ZeroAsset();
    /**
     * @notice Thrown when attempting to create a vault with a zero address controller
     */
    error ZeroController();
    /**
     * @notice Thrown when the asset's decimals cannot be fetched
     */
    error NoDecimals();
    /**
     * @notice Thrown when the underlying asset has more decimals than the normalized standard
     */
    error AssetDecimalsTooHigh();
    /**
     * @notice Thrown when attempting to deposit or withdraw zero assets or shares
     */
    error ZeroAssetsOrShares();

    /**
     * @notice Constructs a new ControlledERC7575Vault
     * @dev Initializes the vault with the specified asset and controller. Automatically determines
     * the decimal offset needed to normalize asset amounts to 18 decimals.
     *
     * Requirements:
     * - `asset_` must not be the zero address
     * - `controller_` must not be the zero address
     * - asset decimals must not exceed 18
     *
     * @param asset_ The ERC20 token that this vault will manage
     * @param controller_ The controller contract that will manage this vault
     */
    constructor(IERC20 asset_, IController controller_) {
        require(address(asset_) != address(0), ZeroAsset());
        require(address(controller_) != address(0), ZeroController());

        _asset = asset_;
        _controller = controller_;

        (bool success, uint8 assetDecimals) = tryGetAssetDecimals(asset_);
        require(success, NoDecimals());
        require(assetDecimals <= NORMALIZED_ASSET_DECIMALS, AssetDecimalsTooHigh());
        _decimalsOffset = NORMALIZED_ASSET_DECIMALS - assetDecimals;
    }

    /**
     * @notice Returns the address of the share token
     * @dev All vaults share the same share token as their share representation
     * @return The address of the share token contract managed by the controller
     */
    function share() external view returns (address) {
        return _controller.share();
    }

    /**
     * @notice Returns the address of the underlying asset token
     * @dev Each vault manages a single underlying asset token
     * @return The address of the underlying asset ERC20 contract
     */
    function asset() external view override(IControlledVault, IERC7575Vault) returns (address) {
        return address(_asset);
    }

    /**
     * @notice Returns the total amount of underlying assets managed by the vault
     * @dev Includes both assets held directly in the vault and any additional assets
     * managed through strategies or other mechanisms (via `_additionalOwnedAssets`)
     * @return The total amount of assets in the asset's native decimal precision
     */
    function totalAssets() public view returns (uint256) {
        return _asset.balanceOf(address(this)) + _additionalOwnedAssets();
    }

    /**
     * @notice Returns the address of the controller contract that manages this vault
     * @dev The controller has special privileges to perform operations like rebalancing
     * @return The address of the controller contract
     */
    function controller() external view returns (address) {
        return address(_controller);
    }

    /**
     * @notice Returns the total amount of normalized assets held by the vault
     * @dev Normalized assets are standardized to 18 decimals regardless of the underlying
     * asset's actual decimal places. Used for consistent cross-vault calculations
     * @return The total normalized asset amount (always in 18 decimals)
     */
    function totalNormalizedAssets() external view returns (uint256) {
        return _upscaleDecimals(totalAssets());
    }

    /**
     * @notice Converts an amount of assets to the equivalent amount of shares
     * @dev In this implementation, shares are 1:1 with normalized assets (18 decimals) due to
     * missing dynamic pricing context that would be required for more complex calculations
     * @param assets The amount of assets to convert (in asset's native decimals)
     * @return The equivalent amount of shares (normalized to 18 decimals)
     */
    function convertToShares(uint256 assets) external view returns (uint256) {
        return _upscaleDecimals(assets);
    }

    /**
     * @notice Converts an amount of shares to the equivalent amount of assets
     * @dev In this implementation, shares are 1:1 with normalized assets (18 decimals) due to
     * missing dynamic pricing context that would be required for more complex calculations
     * @param shares The amount of shares to convert (normalized 18 decimals)
     * @return The equivalent amount of assets (in asset's native decimals)
     */
    function convertToAssets(uint256 shares) external view returns (uint256) {
        return _downscaleDecimals(shares, Math.Rounding.Floor);
    }

    /**
     * @notice Deposits assets into the vault and mints shares to the receiver
     * @dev Transfers assets from the caller, normalizes the amount, and delegates to the controller
     * for share minting. The controller handles the actual share token minting and any
     * cross-vault considerations like dynamic pricing.
     *
     * Requirements:
     * - Caller must have approved this contract to spend `assets` amount
     * - `assets` must not exceed the maximum deposit limit
     *
     * Emits:
     * - {Deposit} event with the deposit details
     *
     * @param assets The amount of assets to deposit (in asset's native decimals)
     * @param receiver The address that will receive the minted shares
     * @return shares The amount of shares minted (normalized to 18 decimals)
     */
    function deposit(uint256 assets, address receiver) external nonReentrant returns (uint256 shares) {
        shares = _controller.deposit(_upscaleDecimals(assets), receiver);
        _deposit(receiver, assets, shares);
    }

    /**
     * @notice Mints a specific amount of shares and deposits the required assets
     * @dev Calculates the required assets through the controller, then transfers assets
     * from the caller. The controller handles the actual share token minting.
     * Assets are calculated using ceiling rounding, which ensures that for any non-zero
     * shares input, the calculated assets will also be non-zero, preventing free share minting.
     *
     * Requirements:
     * - Caller must have approved this contract to spend the calculated `assets` amount
     * - `shares` must not exceed the maximum mint limit
     *
     * Emits:
     * - {Deposit} event with the deposit details
     *
     * @param shares The amount of shares to mint (normalized to 18 decimals)
     * @param receiver The address that will receive the minted shares
     * @return assets The amount of assets deposited (in asset's native decimals)
     */
    function mint(uint256 shares, address receiver) external nonReentrant returns (uint256 assets) {
        assets = _downscaleDecimals(_controller.mint(shares, receiver), Math.Rounding.Ceil);
        _deposit(receiver, assets, shares);
    }

    /**
     * @notice Withdraws a specific amount of assets and burns the required shares
     * @dev Burns shares from the owner through the controller, then transfers assets
     * to the receiver. Handles any necessary asset rebalancing through hooks.
     *
     * Requirements:
     * - If caller is not the owner, they must have sufficient allowance
     * - `assets` must not exceed the maximum withdrawal limit
     * - Vault must have sufficient available assets
     *
     * Emits:
     * - {Withdraw} event with the withdrawal details
     *
     * @param assets The amount of assets to withdraw (in asset's native decimals)
     * @param receiver The address that will receive the withdrawn assets
     * @param owner The address that owns the shares being burned
     * @return shares The amount of shares burned (normalized to 18 decimals)
     */
    function withdraw(
        uint256 assets,
        address receiver,
        address owner
    )
        external
        nonReentrant
        returns (uint256 shares)
    {
        shares = _controller.withdraw(_upscaleDecimals(assets), msg.sender, owner);
        _withdraw(receiver, owner, assets, shares);
    }

    /**
     * @notice Redeems a specific amount of shares for assets
     * @dev Burns shares from the owner through the controller, calculates the assets
     * to withdraw, then transfers assets to the receiver.
     *
     * Requirements:
     * - If caller is not the owner, they must have sufficient allowance
     * - `shares` must not exceed the maximum redemption limit
     * - Vault must have sufficient available assets
     *
     * Emits:
     * - {Withdraw} event with the withdrawal details
     *
     * @param shares The amount of shares to redeem (normalized to 18 decimals)
     * @param receiver The address that will receive the withdrawn assets
     * @param owner The address that owns the shares being burned
     * @return assets The amount of assets withdrawn (in asset's native decimals)
     */
    function redeem(
        uint256 shares,
        address receiver,
        address owner
    )
        external
        nonReentrant
        returns (uint256 assets)
    {
        assets = _downscaleDecimals(_controller.redeem(shares, msg.sender, owner), Math.Rounding.Floor);
        _withdraw(receiver, owner, assets, shares);
    }

    /**
     * @notice Previews the amount of shares that would be minted for a given asset deposit
     * @dev Simulates a deposit operation without executing it. Normalizes the asset amount
     * and delegates to the controller for share calculation based on current pricing.
     * @param assets The amount of assets to preview depositing (in asset's native decimals)
     * @return shares The amount of shares that would be minted (normalized to 18 decimals)
     */
    function previewDeposit(uint256 assets) external view returns (uint256 shares) {
        return _controller.previewDeposit(_upscaleDecimals(assets));
    }

    /**
     * @notice Previews the amount of assets required to mint a given amount of shares
     * @dev Simulates a mint operation without executing it. Delegates to the controller
     * for asset calculation based on current pricing, then denormalizes the result.
     * @param shares The amount of shares to preview minting (normalized to 18 decimals)
     * @return assets The amount of assets that would be required (in asset's native decimals)
     */
    function previewMint(uint256 shares) external view returns (uint256 assets) {
        return _downscaleDecimals(_controller.previewMint(shares), Math.Rounding.Ceil);
    }

    /**
     * @notice Previews the amount of shares that would be burned for a given asset withdrawal
     * @dev Simulates a withdrawal operation without executing it. Normalizes the asset amount
     * and delegates to the controller for share calculation based on current pricing.
     * @param assets The amount of assets to preview withdrawing (in asset's native decimals)
     * @return shares The amount of shares that would be burned (normalized to 18 decimals)
     */
    function previewWithdraw(uint256 assets) external view returns (uint256 shares) {
        return _controller.previewWithdraw(_upscaleDecimals(assets));
    }

    /**
     * @notice Previews the amount of assets that would be withdrawn for a given share redemption
     * @dev Simulates a redemption operation without executing it. Delegates to the controller
     * for asset calculation based on current pricing, then denormalizes the result.
     * @param shares The amount of shares to preview redeeming (normalized to 18 decimals)
     * @return assets The amount of assets that would be withdrawn (in asset's native decimals)
     */
    function previewRedeem(uint256 shares) external view returns (uint256 assets) {
        return _downscaleDecimals(_controller.previewRedeem(shares), Math.Rounding.Floor);
    }

    /**
     * @notice Returns the maximum amount of assets that can be deposited for a given receiver
     * @dev Delegates to the controller which considers protocol-wide limits, vault capacity,
     * and any receiver-specific restrictions. Result is denormalized to asset's native decimals.
     * @param receiver The address that would receive the minted shares
     * @return assets The maximum amount of assets that can be deposited (in asset's native decimals)
     */
    function maxDeposit(address receiver) external view returns (uint256 assets) {
        return _downscaleDecimals(_controller.maxDeposit(receiver), Math.Rounding.Floor);
    }

    /**
     * @notice Returns the maximum amount of shares that can be minted for a given receiver
     * @dev Delegates to the controller which considers protocol-wide limits, vault capacity,
     * and any receiver-specific restrictions.
     * @param receiver The address that would receive the minted shares
     * @return shares The maximum amount of shares that can be minted (normalized to 18 decimals)
     */
    function maxMint(address receiver) external view returns (uint256 shares) {
        return _controller.maxMint(receiver);
    }

    /**
     * @notice Returns the maximum amount of assets that can be withdrawn by a given owner
     * @dev Considers both the controller's limits and the vault's available asset liquidity.
     * The available assets include both vault balance and any immediately accessible
     * assets from strategies.
     * @param owner The address that owns the shares
     * @return assets The maximum amount of assets that can be withdrawn (in asset's native decimals)
     */
    function maxWithdraw(address owner) external view returns (uint256 assets) {
        return
            _downscaleDecimals(
                _controller.maxWithdraw(owner, _upscaleDecimals(_availableAssets())), Math.Rounding.Floor
            );
    }

    /**
     * @notice Returns the maximum amount of shares that can be redeemed by a given owner
     * @dev Considers both the controller's limits and the vault's available asset liquidity.
     * The available assets limit how many shares can actually be redeemed for assets.
     * @param owner The address that owns the shares
     * @return shares The maximum amount of shares that can be redeemed (normalized to 18 decimals)
     */
    function maxRedeem(address owner) external view returns (uint256 shares) {
        return _controller.maxRedeem(owner, _upscaleDecimals(_availableAssets()));
    }

    /**
     * @notice Withdraws assets from the vault by controller
     * @dev This function can only be called by the designated controller contract.
     * It's used during rebalancing operations to redistribute assets across
     * different vaults in the protocol. The function executes any necessary
     * pre-withdrawal hooks.
     *
     * Requirements:
     * - Can only be called by the controller contract
     * - Vault must have sufficient assets to transfer
     *
     * Emits:
     * - {ControllerWithdraw} event with the withdrawn asset amount
     *
     * @param asset_ The address of the asset to withdraw (can be a reward token)
     * @param assets The amount of assets to withdraw (in asset's native decimals)
     * @param receiver The address that will receive the withdrawn assets
     *
     * @custom:security Access restricted to controller only to prevent unauthorized asset drainage
     */
    function controllerWithdraw(address asset_, uint256 assets, address receiver) external nonReentrant {
        require(msg.sender == address(_controller), CallerNotController());
        if (asset_ == address(_asset)) _beforeWithdraw(assets);
        IERC20(asset_).safeTransfer(receiver, assets);
        emit ControllerWithdraw(asset_, assets, receiver);
    }

    /**
     * @notice Deposits assets into the vault by controller
     * @dev This function can only be called by the designated controller contract.
     * It's used during rebalancing operations to allocate assets that are already
     * present in the vault. The controller is expected to transfer the assets into
     * the vault before calling this function. The function executes any necessary
     * post-deposit hooks to properly allocate the assets.
     *
     * Requirements:
     * - Can only be called by the controller contract
     *
     * Emits:
     * - {ControllerDeposit} event with the deposited asset amount
     *
     * @param assets The amount of assets to deposit (in asset's native decimals)
     *
     * @custom:security Access restricted to controller only to prevent unauthorized asset manipulation
     */
    function controllerDeposit(uint256 assets) external nonReentrant {
        require(msg.sender == address(_controller), CallerNotController());
        _afterDeposit(assets);
        emit ControllerDeposit(assets);
    }

    /**
     * @notice Internal function to handle asset deposits and emit events
     * @dev Transfers assets from the caller to the vault, executes post-deposit hooks,
     * and emits the deposit event. Used by both deposit and mint functions.
     *
     * @param receiver The address that received the minted shares
     * @param assets The amount of assets deposited (in asset's native decimals)
     * @param shares The amount of shares minted (normalized to 18 decimals)
     *
     * @custom:security Uses SafeERC20 for secure token transfers
     */
    function _deposit(address receiver, uint256 assets, uint256 shares) private {
        require(assets > 0 && shares > 0, ZeroAssetsOrShares());
        _asset.safeTransferFrom(msg.sender, address(this), assets);
        _afterDeposit(assets);
        emit Deposit(msg.sender, receiver, assets, shares);
    }

    /**
     * @notice Internal function to handle asset withdrawals and emit events
     * @dev Executes pre-withdrawal hooks, transfers assets to the receiver,
     * and emits the withdrawal event. Used by both withdraw and redeem functions.
     *
     * @param receiver The address that will receive the withdrawn assets
     * @param owner The address that owns the shares being burned
     * @param assets The amount of assets withdrawn (in asset's native decimals)
     * @param shares The amount of shares burned (normalized to 18 decimals)
     *
     * @custom:security Uses SafeERC20 for secure token transfers
     */
    function _withdraw(address receiver, address owner, uint256 assets, uint256 shares) private {
        require(assets > 0 && shares > 0, ZeroAssetsOrShares());
        _beforeWithdraw(assets);
        _asset.safeTransfer(receiver, assets);
        emit Withdraw(msg.sender, receiver, owner, assets, shares);
    }

    /**
     * @notice Calculates the total amount of assets immediately available for withdrawal
     * @dev Includes assets held directly in the vault plus any additional assets
     * that can be quickly accessed (e.g., from liquid strategies)
     * @return The total amount of immediately available assets (in asset's native decimals)
     */
    function _availableAssets() private view returns (uint256) {
        return _asset.balanceOf(address(this)) + _additionalAvailableAssets();
    }

    /**
     * @notice Converts an asset amount to normalized decimals (18 decimals)
     * @dev Multiplies by 10^decimalsOffset to scale up from asset's native decimals
     * to the standardized 18 decimal format used throughout the protocol
     * @param value The amount in asset's native decimals
     * @return The amount scaled up to 18 decimals
     */
    function _upscaleDecimals(uint256 value) private view returns (uint256) {
        return value * 10 ** _decimalsOffset;
    }

    /**
     * @notice Converts a normalized amount back to the asset's native decimals
     * @dev Divides by 10^decimalsOffset to scale down from the standardized
     * 18 decimal format to the asset's actual decimal precision
     * @param value The amount in normalized 18 decimals
     * @return The amount scaled down to asset's native decimals
     */
    function _downscaleDecimals(uint256 value, Math.Rounding rounding) private view returns (uint256) {
        uint256 divisor = 10 ** _decimalsOffset;
        uint256 result = value / divisor;
        if (rounding == Math.Rounding.Ceil && value % divisor > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @notice Hook to calculate additional assets owned by the vault beyond its direct balance
     * @dev This virtual function allows child contracts to include assets deployed to strategies,
     * lending protocols, or other yield-generating mechanisms in the total asset calculation.
     * The base implementation returns 0, assuming no additional assets.
     * @return The amount of additional assets owned by the vault (in asset's native decimals)
     *
     * @custom:override Child contracts should override this to include strategy assets
     */
    function _additionalOwnedAssets() internal view virtual returns (uint256) {
        return 0;
    }

    /**
     * @notice Hook to calculate additional assets immediately available for withdrawal
     * @dev This virtual function allows child contracts to include liquid assets from strategies
     * or other sources that can be quickly accessed for withdrawals without requiring
     * complex unwinding operations. The base implementation returns 0.
     * @return The amount of additional available assets (in asset's native decimals)
     *
     * @custom:override Child contracts should override this to include liquid strategy assets
     */
    function _additionalAvailableAssets() internal view virtual returns (uint256) {
        return 0;
    }

    /**
     * @notice Hook executed before asset withdrawals to prepare the vault
     * @dev This virtual function allows child contracts to implement custom logic before
     * withdrawals, such as unwinding positions from strategies, ensuring sufficient
     * liquidity, or updating internal accounting. The base implementation is empty.
     * @param assets The amount of assets about to be withdrawn (in asset's native decimals)
     *
     * @custom:override Child contracts can override this to implement withdrawal preparation logic
     */
    function _beforeWithdraw(uint256 assets) internal virtual { }

    /**
     * @notice Hook executed after asset deposits to process the deposited funds
     * @dev This virtual function allows child contracts to implement custom logic after
     * deposits, such as deploying assets to strategies, updating allocations, or
     * performing other post-deposit operations. The base implementation is empty.
     * @param assets The amount of assets that were deposited (in asset's native decimals)
     *
     * @custom:override Child contracts can override this to implement post-deposit logic
     */
    function _afterDeposit(uint256 assets) internal virtual { }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC20/IERC20.sol)

pragma solidity >=0.4.16;

/**
 * @dev Interface of the ERC-20 standard as defined in the ERC.
 */
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.4.0) (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity >=0.6.2;

import {IERC20} from "../IERC20.sol";

/**
 * @dev Interface for the optional metadata functions from the ERC-20 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.4.0) (interfaces/IERC20.sol)

pragma solidity >=0.4.16;

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.3.0) (token/ERC20/utils/SafeERC20.sol)

pragma solidity ^0.8.20;

import {IERC20} from "../IERC20.sol";
import {IERC1363} from "../../../interfaces/IERC1363.sol";

/**
 * @title SafeERC20
 * @dev Wrappers around ERC-20 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 {
    /**
     * @dev An operation with an ERC-20 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 Variant of {safeTransfer} that returns a bool instead of reverting if the operation is not successful.
     */
    function trySafeTransfer(IERC20 token, address to, uint256 value) internal returns (bool) {
        return _callOptionalReturnBool(token, abi.encodeCall(token.transfer, (to, value)));
    }

    /**
     * @dev Variant of {safeTransferFrom} that returns a bool instead of reverting if the operation is not successful.
     */
    function trySafeTransferFrom(IERC20 token, address from, address to, uint256 value) internal returns (bool) {
        return _callOptionalReturnBool(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.
     *
     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the "client"
     * smart contract uses ERC-7674 to set temporary allowances, then the "client" smart contract should avoid using
     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract
     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.
     */
    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.
     *
     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the "client"
     * smart contract uses ERC-7674 to set temporary allowances, then the "client" smart contract should avoid using
     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract
     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.
     */
    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.
     *
     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function
     * only sets the "standard" allowance. Any temporary allowance will remain active, in addition to the value being
     * set here.
     */
    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 Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no
     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
     * targeting contracts.
     *
     * Reverts if the returned value is other than `true`.
     */
    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {
        if (to.code.length == 0) {
            safeTransfer(token, to, value);
        } else if (!token.transferAndCall(to, value, data)) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target
     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
     * targeting contracts.
     *
     * Reverts if the returned value is other than `true`.
     */
    function transferFromAndCallRelaxed(
        IERC1363 token,
        address from,
        address to,
        uint256 value,
        bytes memory data
    ) internal {
        if (to.code.length == 0) {
            safeTransferFrom(token, from, to, value);
        } else if (!token.transferFromAndCall(from, to, value, data)) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no
     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when
     * targeting contracts.
     *
     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.
     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}
     * once without retrying, and relies on the returned value to be true.
     *
     * Reverts if the returned value is other than `true`.
     */
    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {
        if (to.code.length == 0) {
            forceApprove(token, to, value);
        } else if (!token.approveAndCall(to, value, data)) {
            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 {_callOptionalReturnBool} that reverts if call fails to meet the requirements.
     */
    function _callOptionalReturn(IERC20 token, bytes memory data) private {
        uint256 returnSize;
        uint256 returnValue;
        assembly ("memory-safe") {
            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
            // bubble errors
            if iszero(success) {
                let ptr := mload(0x40)
                returndatacopy(ptr, 0, returndatasize())
                revert(ptr, returndatasize())
            }
            returnSize := returndatasize()
            returnValue := mload(0)
        }

        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {
            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 silently catches all reverts and returns a bool instead.
     */
    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
        bool success;
        uint256 returnSize;
        uint256 returnValue;
        assembly ("memory-safe") {
            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)
            returnSize := returndatasize()
            returnValue := mload(0)
        }
        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.3.0) (utils/math/Math.sol)

pragma solidity ^0.8.20;

import {Panic} from "../Panic.sol";
import {SafeCast} from "./SafeCast.sol";

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Floor, // Toward negative infinity
        Ceil, // Toward positive infinity
        Trunc, // Toward zero
        Expand // Away from zero
    }

    /**
     * @dev Return the 512-bit addition of two uint256.
     *
     * The result is stored in two 256 variables such that sum = high * 2²⁵⁶ + low.
     */
    function add512(uint256 a, uint256 b) internal pure returns (uint256 high, uint256 low) {
        assembly ("memory-safe") {
            low := add(a, b)
            high := lt(low, a)
        }
    }

    /**
     * @dev Return the 512-bit multiplication of two uint256.
     *
     * The result is stored in two 256 variables such that product = high * 2²⁵⁶ + low.
     */
    function mul512(uint256 a, uint256 b) internal pure returns (uint256 high, uint256 low) {
        // 512-bit multiply [high low] = x * y. Compute the product mod 2²⁵⁶ and mod 2²⁵⁶ - 1, then use
        // the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
        // variables such that product = high * 2²⁵⁶ + low.
        assembly ("memory-safe") {
            let mm := mulmod(a, b, not(0))
            low := mul(a, b)
            high := sub(sub(mm, low), lt(mm, low))
        }
    }

    /**
     * @dev Returns the addition of two unsigned integers, with a success flag (no overflow).
     */
    function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
        unchecked {
            uint256 c = a + b;
            success = c >= a;
            result = c * SafeCast.toUint(success);
        }
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, with a success flag (no overflow).
     */
    function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
        unchecked {
            uint256 c = a - b;
            success = c <= a;
            result = c * SafeCast.toUint(success);
        }
    }

    /**
     * @dev Returns the multiplication of two unsigned integers, with a success flag (no overflow).
     */
    function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
        unchecked {
            uint256 c = a * b;
            assembly ("memory-safe") {
                // Only true when the multiplication doesn't overflow
                // (c / a == b) || (a == 0)
                success := or(eq(div(c, a), b), iszero(a))
            }
            // equivalent to: success ? c : 0
            result = c * SafeCast.toUint(success);
        }
    }

    /**
     * @dev Returns the division of two unsigned integers, with a success flag (no division by zero).
     */
    function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
        unchecked {
            success = b > 0;
            assembly ("memory-safe") {
                // The `DIV` opcode returns zero when the denominator is 0.
                result := div(a, b)
            }
        }
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).
     */
    function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
        unchecked {
            success = b > 0;
            assembly ("memory-safe") {
                // The `MOD` opcode returns zero when the denominator is 0.
                result := mod(a, b)
            }
        }
    }

    /**
     * @dev Unsigned saturating addition, bounds to `2²⁵⁶ - 1` instead of overflowing.
     */
    function saturatingAdd(uint256 a, uint256 b) internal pure returns (uint256) {
        (bool success, uint256 result) = tryAdd(a, b);
        return ternary(success, result, type(uint256).max);
    }

    /**
     * @dev Unsigned saturating subtraction, bounds to zero instead of overflowing.
     */
    function saturatingSub(uint256 a, uint256 b) internal pure returns (uint256) {
        (, uint256 result) = trySub(a, b);
        return result;
    }

    /**
     * @dev Unsigned saturating multiplication, bounds to `2²⁵⁶ - 1` instead of overflowing.
     */
    function saturatingMul(uint256 a, uint256 b) internal pure returns (uint256) {
        (bool success, uint256 result) = tryMul(a, b);
        return ternary(success, result, type(uint256).max);
    }

    /**
     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
     *
     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
     * one branch when needed, making this function more expensive.
     */
    function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {
        unchecked {
            // branchless ternary works because:
            // b ^ (a ^ b) == a
            // b ^ 0 == b
            return b ^ ((a ^ b) * SafeCast.toUint(condition));
        }
    }

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

    /**
     * @dev Returns the smallest of two numbers.
     */
    function min(uint256 a, uint256 b) internal pure returns (uint256) {
        return ternary(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.
            Panic.panic(Panic.DIVISION_BY_ZERO);
        }

        // The following calculation ensures accurate ceiling division without overflow.
        // Since a is non-zero, (a - 1) / b will not overflow.
        // The largest possible result occurs when (a - 1) / b is type(uint256).max,
        // but the largest value we can obtain is type(uint256).max - 1, which happens
        // when a = type(uint256).max and b = 1.
        unchecked {
            return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);
        }
    }

    /**
     * @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
     * denominator == 0.
     *
     * 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 {
            (uint256 high, uint256 low) = mul512(x, y);

            // Handle non-overflow cases, 256 by 256 division.
            if (high == 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 low / denominator;
            }

            // Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0.
            if (denominator <= high) {
                Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));
            }

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

            // Make division exact by subtracting the remainder from [high low].
            uint256 remainder;
            assembly ("memory-safe") {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                high := sub(high, gt(remainder, low))
                low := sub(low, 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 ("memory-safe") {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [high low] by twos.
                low := div(low, twos)

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

            // Shift in bits from high into low.
            low |= high * twos;

            // Invert denominator mod 2²⁵⁶. Now that denominator is an odd number, it has an inverse modulo 2²⁵⁶ such
            // that denominator * inv ≡ 1 mod 2²⁵⁶. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv ≡ 1 mod 2⁴.
            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⁸
            inverse *= 2 - denominator * inverse; // inverse mod 2¹⁶
            inverse *= 2 - denominator * inverse; // inverse mod 2³²
            inverse *= 2 - denominator * inverse; // inverse mod 2⁶⁴
            inverse *= 2 - denominator * inverse; // inverse mod 2¹²⁸
            inverse *= 2 - denominator * inverse; // inverse mod 2²⁵⁶

            // 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²⁵⁶. Since the preconditions guarantee that the outcome is
            // less than 2²⁵⁶, this is the final result. We don't need to compute the high bits of the result and high
            // is no longer required.
            result = low * inverse;
            return result;
        }
    }

    /**
     * @dev 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) {
        return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);
    }

    /**
     * @dev Calculates floor(x * y >> n) with full precision. Throws if result overflows a uint256.
     */
    function mulShr(uint256 x, uint256 y, uint8 n) internal pure returns (uint256 result) {
        unchecked {
            (uint256 high, uint256 low) = mul512(x, y);
            if (high >= 1 << n) {
                Panic.panic(Panic.UNDER_OVERFLOW);
            }
            return (high << (256 - n)) | (low >> n);
        }
    }

    /**
     * @dev Calculates x * y >> n with full precision, following the selected rounding direction.
     */
    function mulShr(uint256 x, uint256 y, uint8 n, Rounding rounding) internal pure returns (uint256) {
        return mulShr(x, y, n) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, 1 << n) > 0);
    }

    /**
     * @dev Calculate the modular multiplicative inverse of a number in Z/nZ.
     *
     * If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.
     * If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.
     *
     * If the input value is not inversible, 0 is returned.
     *
     * NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the
     * inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.
     */
    function invMod(uint256 a, uint256 n) internal pure returns (uint256) {
        unchecked {
            if (n == 0) return 0;

            // The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)
            // Used to compute integers x and y such that: ax + ny = gcd(a, n).
            // When the gcd is 1, then the inverse of a modulo n exists and it's x.
            // ax + ny = 1
            // ax = 1 + (-y)n
            // ax ≡ 1 (mod n) # x is the inverse of a modulo n

            // If the remainder is 0 the gcd is n right away.
            uint256 remainder = a % n;
            uint256 gcd = n;

            // Therefore the initial coefficients are:
            // ax + ny = gcd(a, n) = n
            // 0a + 1n = n
            int256 x = 0;
            int256 y = 1;

            while (remainder != 0) {
                uint256 quotient = gcd / remainder;

                (gcd, remainder) = (
                    // The old remainder is the next gcd to try.
                    remainder,
                    // Compute the next remainder.
                    // Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd
                    // where gcd is at most n (capped to type(uint256).max)
                    gcd - remainder * quotient
                );

                (x, y) = (
                    // Increment the coefficient of a.
                    y,
                    // Decrement the coefficient of n.
                    // Can overflow, but the result is casted to uint256 so that the
                    // next value of y is "wrapped around" to a value between 0 and n - 1.
                    x - y * int256(quotient)
                );
            }

            if (gcd != 1) return 0; // No inverse exists.
            return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.
        }
    }

    /**
     * @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.
     *
     * From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is
     * prime, then `a**(p-1) ≡ 1 mod p`. As a consequence, we have `a * a**(p-2) ≡ 1 mod p`, which means that
     * `a**(p-2)` is the modular multiplicative inverse of a in Fp.
     *
     * NOTE: this function does NOT check that `p` is a prime greater than `2`.
     */
    function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {
        unchecked {
            return Math.modExp(a, p - 2, p);
        }
    }

    /**
     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)
     *
     * Requirements:
     * - modulus can't be zero
     * - underlying staticcall to precompile must succeed
     *
     * IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make
     * sure the chain you're using it on supports the precompiled contract for modular exponentiation
     * at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,
     * the underlying function will succeed given the lack of a revert, but the result may be incorrectly
     * interpreted as 0.
     */
    function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {
        (bool success, uint256 result) = tryModExp(b, e, m);
        if (!success) {
            Panic.panic(Panic.DIVISION_BY_ZERO);
        }
        return result;
    }

    /**
     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).
     * It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying
     * to operate modulo 0 or if the underlying precompile reverted.
     *
     * IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain
     * you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in
     * https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack
     * of a revert, but the result may be incorrectly interpreted as 0.
     */
    function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {
        if (m == 0) return (false, 0);
        assembly ("memory-safe") {
            let ptr := mload(0x40)
            // | Offset    | Content    | Content (Hex)                                                      |
            // |-----------|------------|--------------------------------------------------------------------|
            // | 0x00:0x1f | size of b  | 0x0000000000000000000000000000000000000000000000000000000000000020 |
            // | 0x20:0x3f | size of e  | 0x0000000000000000000000000000000000000000000000000000000000000020 |
            // | 0x40:0x5f | size of m  | 0x0000000000000000000000000000000000000000000000000000000000000020 |
            // | 0x60:0x7f | value of b | 0x<.............................................................b> |
            // | 0x80:0x9f | value of e | 0x<.............................................................e> |
            // | 0xa0:0xbf | value of m | 0x<.............................................................m> |
            mstore(ptr, 0x20)
            mstore(add(ptr, 0x20), 0x20)
            mstore(add(ptr, 0x40), 0x20)
            mstore(add(ptr, 0x60), b)
            mstore(add(ptr, 0x80), e)
            mstore(add(ptr, 0xa0), m)

            // Given the result < m, it's guaranteed to fit in 32 bytes,
            // so we can use the memory scratch space located at offset 0.
            success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
            result := mload(0x00)
        }
    }

    /**
     * @dev Variant of {modExp} that supports inputs of arbitrary length.
     */
    function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {
        (bool success, bytes memory result) = tryModExp(b, e, m);
        if (!success) {
            Panic.panic(Panic.DIVISION_BY_ZERO);
        }
        return result;
    }

    /**
     * @dev Variant of {tryModExp} that supports inputs of arbitrary length.
     */
    function tryModExp(
        bytes memory b,
        bytes memory e,
        bytes memory m
    ) internal view returns (bool success, bytes memory result) {
        if (_zeroBytes(m)) return (false, new bytes(0));

        uint256 mLen = m.length;

        // Encode call args in result and move the free memory pointer
        result = abi.encodePacked(b.length, e.length, mLen, b, e, m);

        assembly ("memory-safe") {
            let dataPtr := add(result, 0x20)
            // Write result on top of args to avoid allocating extra memory.
            success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)
            // Overwrite the length.
            // result.length > returndatasize() is guaranteed because returndatasize() == m.length
            mstore(result, mLen)
            // Set the memory pointer after the returned data.
            mstore(0x40, add(dataPtr, mLen))
        }
    }

    /**
     * @dev Returns whether the provided byte array is zero.
     */
    function _zeroBytes(bytes memory byteArray) private pure returns (bool) {
        for (uint256 i = 0; i < byteArray.length; ++i) {
            if (byteArray[i] != 0) {
                return false;
            }
        }
        return true;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
     * towards zero.
     *
     * This method is based on Newton's method for computing square roots; the algorithm is restricted to only
     * using integer operations.
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        unchecked {
            // Take care of easy edge cases when a == 0 or a == 1
            if (a <= 1) {
                return a;
            }

            // In this function, we use Newton's method to get a root of `f(x) := x² - a`. It involves building a
            // sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between
            // the current value as `ε_n = | x_n - sqrt(a) |`.
            //
            // For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root
            // of the target. (i.e. `2**(e-1) ≤ sqrt(a) < 2**e`). We know that `e ≤ 128` because `(2¹²⁸)² = 2²⁵⁶` is
            // bigger than any uint256.
            //
            // By noticing that
            // `2**(e-1) ≤ sqrt(a) < 2**e → (2**(e-1))² ≤ a < (2**e)² → 2**(2*e-2) ≤ a < 2**(2*e)`
            // we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar
            // to the msb function.
            uint256 aa = a;
            uint256 xn = 1;

            if (aa >= (1 << 128)) {
                aa >>= 128;
                xn <<= 64;
            }
            if (aa >= (1 << 64)) {
                aa >>= 64;
                xn <<= 32;
            }
            if (aa >= (1 << 32)) {
                aa >>= 32;
                xn <<= 16;
            }
            if (aa >= (1 << 16)) {
                aa >>= 16;
                xn <<= 8;
            }
            if (aa >= (1 << 8)) {
                aa >>= 8;
                xn <<= 4;
            }
            if (aa >= (1 << 4)) {
                aa >>= 4;
                xn <<= 2;
            }
            if (aa >= (1 << 2)) {
                xn <<= 1;
            }

            // We now have x_n such that `x_n = 2**(e-1) ≤ sqrt(a) < 2**e = 2 * x_n`. This implies ε_n ≤ 2**(e-1).
            //
            // We can refine our estimation by noticing that the middle of that interval minimizes the error.
            // If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to ε_n ≤ 2**(e-2).
            // This is going to be our x_0 (and ε_0)
            xn = (3 * xn) >> 1; // ε_0 := | x_0 - sqrt(a) | ≤ 2**(e-2)

            // From here, Newton's method give us:
            // x_{n+1} = (x_n + a / x_n) / 2
            //
            // One should note that:
            // x_{n+1}² - a = ((x_n + a / x_n) / 2)² - a
            //              = ((x_n² + a) / (2 * x_n))² - a
            //              = (x_n⁴ + 2 * a * x_n² + a²) / (4 * x_n²) - a
            //              = (x_n⁴ + 2 * a * x_n² + a² - 4 * a * x_n²) / (4 * x_n²)
            //              = (x_n⁴ - 2 * a * x_n² + a²) / (4 * x_n²)
            //              = (x_n² - a)² / (2 * x_n)²
            //              = ((x_n² - a) / (2 * x_n))²
            //              ≥ 0
            // Which proves that for all n ≥ 1, sqrt(a) ≤ x_n
            //
            // This gives us the proof of quadratic convergence of the sequence:
            // ε_{n+1} = | x_{n+1} - sqrt(a) |
            //         = | (x_n + a / x_n) / 2 - sqrt(a) |
            //         = | (x_n² + a - 2*x_n*sqrt(a)) / (2 * x_n) |
            //         = | (x_n - sqrt(a))² / (2 * x_n) |
            //         = | ε_n² / (2 * x_n) |
            //         = ε_n² / | (2 * x_n) |
            //
            // For the first iteration, we have a special case where x_0 is known:
            // ε_1 = ε_0² / | (2 * x_0) |
            //     ≤ (2**(e-2))² / (2 * (2**(e-1) + 2**(e-2)))
            //     ≤ 2**(2*e-4) / (3 * 2**(e-1))
            //     ≤ 2**(e-3) / 3
            //     ≤ 2**(e-3-log2(3))
            //     ≤ 2**(e-4.5)
            //
            // For the following iterations, we use the fact that, 2**(e-1) ≤ sqrt(a) ≤ x_n:
            // ε_{n+1} = ε_n² / | (2 * x_n) |
            //         ≤ (2**(e-k))² / (2 * 2**(e-1))
            //         ≤ 2**(2*e-2*k) / 2**e
            //         ≤ 2**(e-2*k)
            xn = (xn + a / xn) >> 1; // ε_1 := | x_1 - sqrt(a) | ≤ 2**(e-4.5)  -- special case, see above
            xn = (xn + a / xn) >> 1; // ε_2 := | x_2 - sqrt(a) | ≤ 2**(e-9)    -- general case with k = 4.5
            xn = (xn + a / xn) >> 1; // ε_3 := | x_3 - sqrt(a) | ≤ 2**(e-18)   -- general case with k = 9
            xn = (xn + a / xn) >> 1; // ε_4 := | x_4 - sqrt(a) | ≤ 2**(e-36)   -- general case with k = 18
            xn = (xn + a / xn) >> 1; // ε_5 := | x_5 - sqrt(a) | ≤ 2**(e-72)   -- general case with k = 36
            xn = (xn + a / xn) >> 1; // ε_6 := | x_6 - sqrt(a) | ≤ 2**(e-144)  -- general case with k = 72

            // Because e ≤ 128 (as discussed during the first estimation phase), we know have reached a precision
            // ε_6 ≤ 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either
            // sqrt(a) or sqrt(a) + 1.
            return xn - SafeCast.toUint(xn > a / xn);
        }
    }

    /**
     * @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);
        }
    }

    /**
     * @dev Return the log in base 2 of a positive value rounded towards zero.
     * Returns 0 if given 0.
     */
    function log2(uint256 x) internal pure returns (uint256 r) {
        // If value has upper 128 bits set, log2 result is at least 128
        r = SafeCast.toUint(x > 0xffffffffffffffffffffffffffffffff) << 7;
        // If upper 64 bits of 128-bit half set, add 64 to result
        r |= SafeCast.toUint((x >> r) > 0xffffffffffffffff) << 6;
        // If upper 32 bits of 64-bit half set, add 32 to result
        r |= SafeCast.toUint((x >> r) > 0xffffffff) << 5;
        // If upper 16 bits of 32-bit half set, add 16 to result
        r |= SafeCast.toUint((x >> r) > 0xffff) << 4;
        // If upper 8 bits of 16-bit half set, add 8 to result
        r |= SafeCast.toUint((x >> r) > 0xff) << 3;
        // If upper 4 bits of 8-bit half set, add 4 to result
        r |= SafeCast.toUint((x >> r) > 0xf) << 2;

        // Shifts value right by the current result and use it as an index into this lookup table:
        //
        // | x (4 bits) |  index  | table[index] = MSB position |
        // |------------|---------|-----------------------------|
        // |    0000    |    0    |        table[0] = 0         |
        // |    0001    |    1    |        table[1] = 0         |
        // |    0010    |    2    |        table[2] = 1         |
        // |    0011    |    3    |        table[3] = 1         |
        // |    0100    |    4    |        table[4] = 2         |
        // |    0101    |    5    |        table[5] = 2         |
        // |    0110    |    6    |        table[6] = 2         |
        // |    0111    |    7    |        table[7] = 2         |
        // |    1000    |    8    |        table[8] = 3         |
        // |    1001    |    9    |        table[9] = 3         |
        // |    1010    |   10    |        table[10] = 3        |
        // |    1011    |   11    |        table[11] = 3        |
        // |    1100    |   12    |        table[12] = 3        |
        // |    1101    |   13    |        table[13] = 3        |
        // |    1110    |   14    |        table[14] = 3        |
        // |    1111    |   15    |        table[15] = 3        |
        //
        // The lookup table is represented as a 32-byte value with the MSB positions for 0-15 in the last 16 bytes.
        assembly ("memory-safe") {
            r := or(r, byte(shr(r, x), 0x0000010102020202030303030303030300000000000000000000000000000000))
        }
    }

    /**
     * @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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);
        }
    }

    /**
     * @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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);
        }
    }

    /**
     * @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 x) internal pure returns (uint256 r) {
        // If value has upper 128 bits set, log2 result is at least 128
        r = SafeCast.toUint(x > 0xffffffffffffffffffffffffffffffff) << 7;
        // If upper 64 bits of 128-bit half set, add 64 to result
        r |= SafeCast.toUint((x >> r) > 0xffffffffffffffff) << 6;
        // If upper 32 bits of 64-bit half set, add 32 to result
        r |= SafeCast.toUint((x >> r) > 0xffffffff) << 5;
        // If upper 16 bits of 32-bit half set, add 16 to result
        r |= SafeCast.toUint((x >> r) > 0xffff) << 4;
        // Add 1 if upper 8 bits of 16-bit half set, and divide accumulated result by 8
        return (r >> 3) | SafeCast.toUint((x >> r) > 0xff);
    }

    /**
     * @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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);
        }
    }

    /**
     * @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.3.0) (utils/ReentrancyGuardTransient.sol)

pragma solidity ^0.8.24;

import {TransientSlot} from "./TransientSlot.sol";

/**
 * @dev Variant of {ReentrancyGuard} that uses transient storage.
 *
 * NOTE: This variant only works on networks where EIP-1153 is available.
 *
 * _Available since v5.1._
 */
abstract contract ReentrancyGuardTransient {
    using TransientSlot for *;

    // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ReentrancyGuard")) - 1)) & ~bytes32(uint256(0xff))
    bytes32 private constant REENTRANCY_GUARD_STORAGE =
        0x9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00;

    /**
     * @dev Unauthorized reentrant call.
     */
    error ReentrancyGuardReentrantCall();

    /**
     * @dev Prevents a contract from calling itself, directly or indirectly.
     * Calling a `nonReentrant` function from another `nonReentrant`
     * function is not supported. It is possible to prevent this from happening
     * by making the `nonReentrant` function external, and making it call a
     * `private` function that does the actual work.
     */
    modifier nonReentrant() {
        _nonReentrantBefore();
        _;
        _nonReentrantAfter();
    }

    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, REENTRANCY_GUARD_STORAGE.asBoolean().tload() will be false
        if (_reentrancyGuardEntered()) {
            revert ReentrancyGuardReentrantCall();
        }

        // Any calls to nonReentrant after this point will fail
        REENTRANCY_GUARD_STORAGE.asBoolean().tstore(true);
    }

    function _nonReentrantAfter() private {
        REENTRANCY_GUARD_STORAGE.asBoolean().tstore(false);
    }

    /**
     * @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) {
        return REENTRANCY_GUARD_STORAGE.asBoolean().tload();
    }
}

// SPDX-License-Identifier: BUSL-1.1
pragma solidity >=0.8.0;

/**
 * @title IControlledVault
 * @notice Interface for vaults that can be managed by a controller contract
 * @dev This interface enables controller contracts to interact with and manage vault operations,
 * particularly for rebalancing and asset management purposes. Implementing contracts must
 * ensure proper access control to prevent unauthorized operations.
 */
interface IControlledVault {
    /**
     * @notice Emitted when assets are withdrawn from the vault by the controller
     * @dev This event is triggered when the controller initiates a withdrawal for
     * rebalancing operations or rewards swapping activities
     * @param asset The address of the asset withdrawn (can be a reward token)
     * @param assets The amount of assets withdrawn from the vault
     * @param receiver The address that received the withdrawn assets
     */
    event ControllerWithdraw(address indexed asset, uint256 assets, address indexed receiver);

    /**
     * @notice Emitted when assets are deposited into the vault by the controller
     * @dev This event is triggered when the controller deposits assets into the vault
     * for rebalancing operations or following rewards swapping activities
     * @param assets The amount of assets deposited into the vault
     */
    event ControllerDeposit(uint256 assets);

    /**
     * @notice Thrown when a caller other than the designated controller attempts to perform
     * a controller-only operation
     * @dev This error ensures that only the authorized controller can execute sensitive
     * vault management functions
     */
    error CallerNotController();

    /**
     * @notice Returns the address of the underlying asset managed by the vault
     * @dev This is typically an ERC20 token address that the vault holds and manages
     * @return The address of the underlying asset
     */
    function asset() external view returns (address);

    /**
     * @notice Returns the address of the controller contract that manages this vault
     * @dev The controller has special privileges to perform operations like rebalancing
     * @return The address of the controller contract
     */
    function controller() external view returns (address);

    /**
     * @notice Returns the total amount of normalized assets held by the vault
     * @dev Normalized assets are standardized to 18 decimals regardless of the underlying
     * asset's actual decimal places. The vault automatically scales asset amounts
     * up or down to maintain this 18-decimal standard for consistent cross-vault
     * calculations and comparisons
     * @return The total normalized asset amount (always in 18 decimals)
     */
    function totalNormalizedAssets() external view returns (uint256);

    /**
     * @notice Withdraws a specified amount of assets from the vault by controller
     * @dev This function can only be called by the designated controller contract.
     * It's typically used during rebalancing operations to redistribute assets
     * across different vaults.
     * @param asset The address of the asset to withdraw (can be a reward token)
     * @param assets The amount of assets to withdraw (in asset's native decimals)
     * @param receiver The address that will receive the withdrawn assets
     */
    function controllerWithdraw(address asset, uint256 assets, address receiver) external;

    /**
     * @notice Deposits a specified amount of assets into the vault by controller
     * @dev This function can only be called by the designated controller contract.
     * It's typically used to add assets back into the vault following a rebalancing operation.
     * @param assets The amount of assets to deposit (in asset's native decimals)
     */
    function controllerDeposit(uint256 assets) external;
}

// SPDX-License-Identifier: BUSL-1.1
pragma solidity >=0.8.0;

/**
 * @title IController
 * @notice Interface for the Controller contract that handles conversion logic and share token operations
 * @dev This interface defines the core functionality for asset-to-share conversion calculations
 *      and share token minting/burning. The Controller is called by vaults to perform
 *      conversion logic while the vaults themselves handle asset transfers
 */
interface IController {
    /**
     * @notice Returns the address of the Vault for the given asset
     * @param asset The address of the asset
     * @return The address of the associated Vault
     */
    function vaultFor(address asset) external view returns (address);

    /**
     * @notice Returns the address of the share token contract
     * @return The address of the share token
     */
    function share() external view returns (address);

    /**
     * @notice Calculates shares to mint and mints share tokens based on deposited assets
     * @dev Called by vaults after they receive asset transfers. Handles conversion logic and share minting
     * @param assets The amount of assets that were deposited into the vault
     * @param receiver The address that will receive the minted shares
     * @return shares The amount of shares minted to the receiver
     */
    function deposit(uint256 assets, address receiver) external returns (uint256 shares);

    /**
     * @notice Calculates required assets and mints specified shares to receiver
     * @dev Called by vaults to determine asset requirements and mint share tokens
     * @param shares The amount of shares to mint
     * @param receiver The address that will receive the minted shares
     * @return assets The amount of assets required from the vault for the minted shares
     */
    function mint(uint256 shares, address receiver) external returns (uint256 assets);

    /**
     * @notice Calculates shares to burn and burns them for asset withdrawal
     * @dev Called by vaults before they transfer assets. Handles conversion logic and share burning
     * @param assets The amount of assets to be withdrawn by the vault
     * @param spender The address that is burning the shares
     * @param owner The address that owns the shares being burned
     * @return shares The amount of shares burned from the owner
     */
    function withdraw(uint256 assets, address spender, address owner) external returns (uint256 shares);

    /**
     * @notice Burns specified shares and calculates equivalent asset amount
     * @dev Called by vaults to burn share tokens and determine asset transfer amounts
     * @param shares The amount of shares to burn
     * @param spender The address that is burning the shares
     * @param owner The address that owns the shares being burned
     * @return assets The amount of assets the vault should transfer to the receiver
     */
    function redeem(uint256 shares, address spender, address owner) external returns (uint256 assets);

    /**
     * @notice Calculates the amount of shares that would be minted for a given asset amount
     * @param assets The amount of assets to calculate shares for
     * @return shares The amount of shares that would be minted
     */
    function previewDeposit(uint256 assets) external view returns (uint256 shares);

    /**
     * @notice Calculates the amount of assets required to mint a specified amount of shares
     * @param shares The amount of shares to calculate asset requirements for
     * @return assets The amount of assets required to mint the specified shares
     */
    function previewMint(uint256 shares) external view returns (uint256 assets);

    /**
     * @notice Calculates the amount of shares that would be burned for a given asset withdrawal
     * @param assets The amount of assets to calculate share burn for
     * @return shares The amount of shares that would be burned
     */
    function previewWithdraw(uint256 assets) external view returns (uint256 shares);

    /**
     * @notice Calculates the amount of assets equivalent to burning specified shares
     * @param shares The amount of shares to calculate asset equivalent for
     * @return assets The amount of assets equivalent to the specified shares
     */
    function previewRedeem(uint256 shares) external view returns (uint256 assets);

    /**
     * @notice Returns the maximum amount of assets that can be processed for share minting
     * @param receiver The address that would receive the minted shares
     * @return The maximum amount of assets that can be converted to shares
     */
    function maxDeposit(address receiver) external view returns (uint256);

    /**
     * @notice Returns the maximum amount of shares that can be minted to the receiver
     * @param receiver The address that would receive the minted shares
     * @return The maximum amount of shares that can be minted
     */
    function maxMint(address receiver) external view returns (uint256);

    /**
     * @notice Returns the maximum amount of assets that can be processed for share burning
     * @param owner The address that owns the shares
     * @param availableAssets The amount of assets currently available in the vault
     * @return The maximum amount of assets that can be withdrawn through share burning
     */
    function maxWithdraw(address owner, uint256 availableAssets) external view returns (uint256);

    /**
     * @notice Returns the maximum amount of shares that can be burned by the owner
     * @param owner The address that owns the shares
     * @param availableAssets The amount of assets currently available in the vault
     * @return The maximum amount of shares that can be redeemed
     */
    function maxRedeem(address owner, uint256 availableAssets) external view returns (uint256);
}

// SPDX-License-Identifier: BUSL-1.1
pragma solidity >=0.8.0;

/**
 * @title IERC7575Vault
 * @notice Interface for ERC7575-compliant vault contracts
 * @dev This interface defines the core vault operations for managing individual collateral assets
 * within the multi-asset ecosystem.
 */
interface IERC7575Vault {
    /**
     * @notice Emitted when assets are deposited into the vault
     * @dev This event follows the ERC7575 standard for deposit operations
     * @param sender The address that initiated the deposit transaction
     * @param owner The address that will own the minted shares (same as receiver in this implementation)
     * @param assets The amount of underlying assets deposited
     * @param shares The amount of shares minted (calculated using dynamic pricing)
     */
    event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares);

    /**
     * @notice Emitted when assets are withdrawn from the vault
     * @dev This event follows the ERC7575 standard for withdrawal operations
     * @param sender The address that initiated the withdrawal transaction
     * @param receiver The address that receives the withdrawn assets
     * @param owner The address that owns the shares being redeemed
     * @param assets The amount of underlying assets withdrawn
     * @param shares The amount of shares burned (calculated using dynamic pricing)
     */
    event Withdraw(
        address indexed sender, address indexed receiver, address indexed owner, uint256 assets, uint256 shares
    );

    /**
     * @notice Returns the address of the share token
     * @return The address of the share token contract
     */
    function share() external view returns (address);

    /**
     * @notice Returns the address of the underlying asset token
     * @dev Each vault manages a single underlying asset
     * @return The address of the underlying asset ERC20 contract
     */
    function asset() external view returns (address);

    /**
     * @notice Returns the total amount of underlying assets managed by the vault
     * @dev This includes assets held directly in the vault plus assets deployed to yield strategies
     * @return The total amount of underlying assets in the vault's management
     */
    function totalAssets() external view returns (uint256);

    /**
     * @notice Converts an amount of assets to the equivalent amount of shares
     * @dev Returns the exchange rate between vault shares and underlying assets.
     * Always returns a 1:1 ratio because to calculate the proper value via dynamic pricing,
     * the contract would need to know if it's a deposit or withdraw operation.
     * @param assets The amount of underlying assets to convert
     * @return The equivalent amount of shares
     */
    function convertToShares(uint256 assets) external view returns (uint256);

    /**
     * @notice Converts an amount of shares to the equivalent amount of assets
     * @dev Returns the exchange rate between vault shares and underlying assets.
     * Always returns a 1:1 ratio because to calculate the proper value via dynamic pricing,
     * the contract would need to know if it's a deposit or withdraw operation.
     * @param shares The amount of shares to convert
     * @return The equivalent amount of underlying assets
     */
    function convertToAssets(uint256 shares) external view returns (uint256);

    /**
     * @notice Deposits assets into the vault and mints shares to the receiver
     * @param assets The amount of underlying assets to deposit
     * @param receiver The address that will receive the minted shares
     * @return shares The amount of shares minted (calculated using dynamic pricing)
     */
    function deposit(uint256 assets, address receiver) external returns (uint256 shares);

    /**
     * @notice Mints a specific amount of shares by depositing the required assets
     * @param shares The exact amount of shares to mint
     * @param receiver The address that will receive the minted shares
     * @return assets The amount of underlying assets required and deposited
     */
    function mint(uint256 shares, address receiver) external returns (uint256 assets);

    /**
     * @notice Withdraws a specific amount of assets by burning the required shares
     * @param assets The exact amount of underlying assets to withdraw
     * @param receiver The address that will receive the withdrawn assets
     * @param owner The address that owns the shares to be burned
     * @return shares The amount of shares burned (calculated using dynamic pricing)
     */
    function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);

    /**
     * @notice Burns shares and withdraws the equivalent amount of assets
     * @param shares The amount of shares to burn
     * @param receiver The address that will receive the withdrawn assets
     * @param owner The address that owns the shares to be burned
     * @return assets The amount of underlying assets withdrawn (calculated using dynamic pricing)
     */
    function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);

    /**
     * @notice Simulates the effects of a deposit without executing it
     * @dev Calculates how many shares would be minted for a given asset deposit
     * using current dynamic pricing from the Controller
     * @param assets The amount of underlying assets to simulate depositing
     * @return shares The amount of shares that would be minted
     */
    function previewDeposit(uint256 assets) external view returns (uint256 shares);

    /**
     * @notice Simulates the effects of a mint without executing it
     * @dev Calculates how many assets would be required to mint a given amount of shares
     * using current dynamic pricing from the Controller
     * @param shares The amount of shares to simulate minting
     * @return assets The amount of underlying assets that would be required
     */
    function previewMint(uint256 shares) external view returns (uint256 assets);

    /**
     * @notice Simulates the effects of a withdrawal without executing it
     * @dev Calculates how many shares would be burned for a given asset withdrawal
     * using current dynamic pricing from the Controller
     * @param assets The amount of underlying assets to simulate withdrawing
     * @return shares The amount of shares that would be burned
     */
    function previewWithdraw(uint256 assets) external view returns (uint256 shares);

    /**
     * @notice Simulates the effects of a redemption without executing it
     * @dev Calculates how many assets would be withdrawn for a given amount of shares
     * using current dynamic pricing from the Controller
     * @param shares The amount of shares to simulate redeeming
     * @return assets The amount of underlying assets that would be withdrawn
     */
    function previewRedeem(uint256 shares) external view returns (uint256 assets);

    /**
     * @notice Returns the maximum amount of assets that can be deposited for a given receiver
     * @dev Takes into account vault capacity limits
     * @param receiver The address that would receive the minted shares
     * @return The maximum amount of underlying assets that can be deposited
     */
    function maxDeposit(address receiver) external view returns (uint256);

    /**
     * @notice Returns the maximum amount of shares that can be minted for a given receiver
     * @dev Takes into account vault capacity limits
     * @param receiver The address that would receive the minted shares
     * @return The maximum amount of shares that can be minted
     */
    function maxMint(address receiver) external view returns (uint256);

    /**
     * @notice Returns the maximum amount of assets that can be withdrawn by a given owner
     * @dev Takes into account owner's share balance and vault capacity limits
     * @param owner The address that owns the shares to be burned
     * @return The maximum amount of underlying assets that can be withdrawn
     */
    function maxWithdraw(address owner) external view returns (uint256);

    /**
     * @notice Returns the maximum amount of shares that can be redeemed by a given owner
     * @dev Takes into account owner's share balance and vault capacity limits
     * @param owner The address that owns the shares to be burned
     * @return The maximum amount of shares that can be redeemed
     */
    function maxRedeem(address owner) external view returns (uint256);
}

// SPDX-License-Identifier: BUSL-1.1
pragma solidity 0.8.29;

import { IERC20 } from "@openzeppelin/contracts/interfaces/IERC20.sol";
import { IERC20Metadata } from "@openzeppelin/contracts/interfaces/IERC20Metadata.sol";

/**
 * @notice Safely attempts to retrieve the decimal places of an ERC20 token
 * @dev Uses a low-level staticcall to avoid reverting if the token doesn't implement decimals()
 * or if the implementation is non-standard. Validates that the returned value fits in uint8.
 * @param asset_ The ERC20 token contract to query
 * @return ok True if the decimals were successfully retrieved and are valid, false otherwise
 * @return assetDecimals The number of decimal places for the token (0-255), or 0 if retrieval failed
 */
function tryGetAssetDecimals(IERC20 asset_) view returns (bool ok, uint8 assetDecimals) {
    (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) {
            // casting to 'uint8' is safe because 'returnedDecimals' is guaranteed to be less than or equal to
            // 'type(uint8).max'
            // forge-lint: disable-next-line(unsafe-typecast)
            return (true, uint8(returnedDecimals));
        }
    }
    return (false, 0);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC1363.sol)

pragma solidity >=0.6.2;

import {IERC20} from "./IERC20.sol";
import {IERC165} from "./IERC165.sol";

/**
 * @title IERC1363
 * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].
 *
 * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract
 * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.
 */
interface IERC1363 is IERC20, IERC165 {
    /*
     * Note: the ERC-165 identifier for this interface is 0xb0202a11.
     * 0xb0202a11 ===
     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^
     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^
     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^
     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^
     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^
     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))
     */

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferAndCall(address to, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @param data Additional data with no specified format, sent in call to `to`.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param from The address which you want to send tokens from.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism
     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.
     * @param from The address which you want to send tokens from.
     * @param to The address which you want to transfer to.
     * @param value The amount of tokens to be transferred.
     * @param data Additional data with no specified format, sent in call to `to`.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.
     * @param spender The address which will spend the funds.
     * @param value The amount of tokens to be spent.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function approveAndCall(address spender, uint256 value) external returns (bool);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.
     * @param spender The address which will spend the funds.
     * @param value The amount of tokens to be spent.
     * @param data Additional data with no specified format, sent in call to `spender`.
     * @return A boolean value indicating whether the operation succeeded unless throwing.
     */
    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)

pragma solidity ^0.8.20;

/**
 * @dev Helper library for emitting standardized panic codes.
 *
 * ```solidity
 * contract Example {
 *      using Panic for uint256;
 *
 *      // Use any of the declared internal constants
 *      function foo() { Panic.GENERIC.panic(); }
 *
 *      // Alternatively
 *      function foo() { Panic.panic(Panic.GENERIC); }
 * }
 * ```
 *
 * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].
 *
 * _Available since v5.1._
 */
// slither-disable-next-line unused-state
library Panic {
    /// @dev generic / unspecified error
    uint256 internal constant GENERIC = 0x00;
    /// @dev used by the assert() builtin
    uint256 internal constant ASSERT = 0x01;
    /// @dev arithmetic underflow or overflow
    uint256 internal constant UNDER_OVERFLOW = 0x11;
    /// @dev division or modulo by zero
    uint256 internal constant DIVISION_BY_ZERO = 0x12;
    /// @dev enum conversion error
    uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;
    /// @dev invalid encoding in storage
    uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;
    /// @dev empty array pop
    uint256 internal constant EMPTY_ARRAY_POP = 0x31;
    /// @dev array out of bounds access
    uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;
    /// @dev resource error (too large allocation or too large array)
    uint256 internal constant RESOURCE_ERROR = 0x41;
    /// @dev calling invalid internal function
    uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;

    /// @dev Reverts with a panic code. Recommended to use with
    /// the internal constants with predefined codes.
    function panic(uint256 code) internal pure {
        assembly ("memory-safe") {
            mstore(0x00, 0x4e487b71)
            mstore(0x20, code)
            revert(0x1c, 0x24)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)
// This file was procedurally generated from scripts/generate/templates/SafeCast.js.

pragma solidity ^0.8.20;

/**
 * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow
 * checks.
 *
 * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
 * easily result in undesired exploitation or bugs, since developers usually
 * assume that overflows raise errors. `SafeCast` restores this intuition by
 * reverting the transaction when such an operation overflows.
 *
 * Using this library instead of the unchecked operations eliminates an entire
 * class of bugs, so it's recommended to use it always.
 */
library SafeCast {
    /**
     * @dev Value doesn't fit in an uint of `bits` size.
     */
    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);

    /**
     * @dev An int value doesn't fit in an uint of `bits` size.
     */
    error SafeCastOverflowedIntToUint(int256 value);

    /**
     * @dev Value doesn't fit in an int of `bits` size.
     */
    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);

    /**
     * @dev An uint value doesn't fit in an int of `bits` size.
     */
    error SafeCastOverflowedUintToInt(uint256 value);

    /**
     * @dev Returns the downcasted uint248 from uint256, reverting on
     * overflow (when the input is greater than largest uint248).
     *
     * Counterpart to Solidity's `uint248` operator.
     *
     * Requirements:
     *
     * - input must fit into 248 bits
     */
    function toUint248(uint256 value) internal pure returns (uint248) {
        if (value > type(uint248).max) {
            revert SafeCastOverflowedUintDowncast(248, value);
        }
        return uint248(value);
    }

    /**
     * @dev Returns the downcasted uint240 from uint256, reverting on
     * overflow (when the input is greater than largest uint240).
     *
     * Counterpart to Solidity's `uint240` operator.
     *
     * Requirements:
     *
     * - input must fit into 240 bits
     */
    function toUint240(uint256 value) internal pure returns (uint240) {
        if (value > type(uint240).max) {
            revert SafeCastOverflowedUintDowncast(240, value);
        }
        return uint240(value);
    }

    /**
     * @dev Returns the downcasted uint232 from uint256, reverting on
     * overflow (when the input is greater than largest uint232).
     *
     * Counterpart to Solidity's `uint232` operator.
     *
     * Requirements:
     *
     * - input must fit into 232 bits
     */
    function toUint232(uint256 value) internal pure returns (uint232) {
        if (value > type(uint232).max) {
            revert SafeCastOverflowedUintDowncast(232, value);
        }
        return uint232(value);
    }

    /**
     * @dev Returns the downcasted uint224 from uint256, reverting on
     * overflow (when the input is greater than largest uint224).
     *
     * Counterpart to Solidity's `uint224` operator.
     *
     * Requirements:
     *
     * - input must fit into 224 bits
     */
    function toUint224(uint256 value) internal pure returns (uint224) {
        if (value > type(uint224).max) {
            revert SafeCastOverflowedUintDowncast(224, value);
        }
        return uint224(value);
    }

    /**
     * @dev Returns the downcasted uint216 from uint256, reverting on
     * overflow (when the input is greater than largest uint216).
     *
     * Counterpart to Solidity's `uint216` operator.
     *
     * Requirements:
     *
     * - input must fit into 216 bits
     */
    function toUint216(uint256 value) internal pure returns (uint216) {
        if (value > type(uint216).max) {
            revert SafeCastOverflowedUintDowncast(216, value);
        }
        return uint216(value);
    }

    /**
     * @dev Returns the downcasted uint208 from uint256, reverting on
     * overflow (when the input is greater than largest uint208).
     *
     * Counterpart to Solidity's `uint208` operator.
     *
     * Requirements:
     *
     * - input must fit into 208 bits
     */
    function toUint208(uint256 value) internal pure returns (uint208) {
        if (value > type(uint208).max) {
            revert SafeCastOverflowedUintDowncast(208, value);
        }
        return uint208(value);
    }

    /**
     * @dev Returns the downcasted uint200 from uint256, reverting on
     * overflow (when the input is greater than largest uint200).
     *
     * Counterpart to Solidity's `uint200` operator.
     *
     * Requirements:
     *
     * - input must fit into 200 bits
     */
    function toUint200(uint256 value) internal pure returns (uint200) {
        if (value > type(uint200).max) {
            revert SafeCastOverflowedUintDowncast(200, value);
        }
        return uint200(value);
    }

    /**
     * @dev Returns the downcasted uint192 from uint256, reverting on
     * overflow (when the input is greater than largest uint192).
     *
     * Counterpart to Solidity's `uint192` operator.
     *
     * Requirements:
     *
     * - input must fit into 192 bits
     */
    function toUint192(uint256 value) internal pure returns (uint192) {
        if (value > type(uint192).max) {
            revert SafeCastOverflowedUintDowncast(192, value);
        }
        return uint192(value);
    }

    /**
     * @dev Returns the downcasted uint184 from uint256, reverting on
     * overflow (when the input is greater than largest uint184).
     *
     * Counterpart to Solidity's `uint184` operator.
     *
     * Requirements:
     *
     * - input must fit into 184 bits
     */
    function toUint184(uint256 value) internal pure returns (uint184) {
        if (value > type(uint184).max) {
            revert SafeCastOverflowedUintDowncast(184, value);
        }
        return uint184(value);
    }

    /**
     * @dev Returns the downcasted uint176 from uint256, reverting on
     * overflow (when the input is greater than largest uint176).
     *
     * Counterpart to Solidity's `uint176` operator.
     *
     * Requirements:
     *
     * - input must fit into 176 bits
     */
    function toUint176(uint256 value) internal pure returns (uint176) {
        if (value > type(uint176).max) {
            revert SafeCastOverflowedUintDowncast(176, value);
        }
        return uint176(value);
    }

    /**
     * @dev Returns the downcasted uint168 from uint256, reverting on
     * overflow (when the input is greater than largest uint168).
     *
     * Counterpart to Solidity's `uint168` operator.
     *
     * Requirements:
     *
     * - input must fit into 168 bits
     */
    function toUint168(uint256 value) internal pure returns (uint168) {
        if (value > type(uint168).max) {
            revert SafeCastOverflowedUintDowncast(168, value);
        }
        return uint168(value);
    }

    /**
     * @dev Returns the downcasted uint160 from uint256, reverting on
     * overflow (when the input is greater than largest uint160).
     *
     * Counterpart to Solidity's `uint160` operator.
     *
     * Requirements:
     *
     * - input must fit into 160 bits
     */
    function toUint160(uint256 value) internal pure returns (uint160) {
        if (value > type(uint160).max) {
            revert SafeCastOverflowedUintDowncast(160, value);
        }
        return uint160(value);
    }

    /**
     * @dev Returns the downcasted uint152 from uint256, reverting on
     * overflow (when the input is greater than largest uint152).
     *
     * Counterpart to Solidity's `uint152` operator.
     *
     * Requirements:
     *
     * - input must fit into 152 bits
     */
    function toUint152(uint256 value) internal pure returns (uint152) {
        if (value > type(uint152).max) {
            revert SafeCastOverflowedUintDowncast(152, value);
        }
        return uint152(value);
    }

    /**
     * @dev Returns the downcasted uint144 from uint256, reverting on
     * overflow (when the input is greater than largest uint144).
     *
     * Counterpart to Solidity's `uint144` operator.
     *
     * Requirements:
     *
     * - input must fit into 144 bits
     */
    function toUint144(uint256 value) internal pure returns (uint144) {
        if (value > type(uint144).max) {
            revert SafeCastOverflowedUintDowncast(144, value);
        }
        return uint144(value);
    }

    /**
     * @dev Returns the downcasted uint136 from uint256, reverting on
     * overflow (when the input is greater than largest uint136).
     *
     * Counterpart to Solidity's `uint136` operator.
     *
     * Requirements:
     *
     * - input must fit into 136 bits
     */
    function toUint136(uint256 value) internal pure returns (uint136) {
        if (value > type(uint136).max) {
            revert SafeCastOverflowedUintDowncast(136, value);
        }
        return uint136(value);
    }

    /**
     * @dev Returns the downcasted uint128 from uint256, reverting on
     * overflow (when the input is greater than largest uint128).
     *
     * Counterpart to Solidity's `uint128` operator.
     *
     * Requirements:
     *
     * - input must fit into 128 bits
     */
    function toUint128(uint256 value) internal pure returns (uint128) {
        if (value > type(uint128).max) {
            revert SafeCastOverflowedUintDowncast(128, value);
        }
        return uint128(value);
    }

    /**
     * @dev Returns the downcasted uint120 from uint256, reverting on
     * overflow (when the input is greater than largest uint120).
     *
     * Counterpart to Solidity's `uint120` operator.
     *
     * Requirements:
     *
     * - input must fit into 120 bits
     */
    function toUint120(uint256 value) internal pure returns (uint120) {
        if (value > type(uint120).max) {
            revert SafeCastOverflowedUintDowncast(120, value);
        }
        return uint120(value);
    }

    /**
     * @dev Returns the downcasted uint112 from uint256, reverting on
     * overflow (when the input is greater than largest uint112).
     *
     * Counterpart to Solidity's `uint112` operator.
     *
     * Requirements:
     *
     * - input must fit into 112 bits
     */
    function toUint112(uint256 value) internal pure returns (uint112) {
        if (value > type(uint112).max) {
            revert SafeCastOverflowedUintDowncast(112, value);
        }
        return uint112(value);
    }

    /**
     * @dev Returns the downcasted uint104 from uint256, reverting on
     * overflow (when the input is greater than largest uint104).
     *
     * Counterpart to Solidity's `uint104` operator.
     *
     * Requirements:
     *
     * - input must fit into 104 bits
     */
    function toUint104(uint256 value) internal pure returns (uint104) {
        if (value > type(uint104).max) {
            revert SafeCastOverflowedUintDowncast(104, value);
        }
        return uint104(value);
    }

    /**
     * @dev Returns the downcasted uint96 from uint256, reverting on
     * overflow (when the input is greater than largest uint96).
     *
     * Counterpart to Solidity's `uint96` operator.
     *
     * Requirements:
     *
     * - input must fit into 96 bits
     */
    function toUint96(uint256 value) internal pure returns (uint96) {
        if (value > type(uint96).max) {
            revert SafeCastOverflowedUintDowncast(96, value);
        }
        return uint96(value);
    }

    /**
     * @dev Returns the downcasted uint88 from uint256, reverting on
     * overflow (when the input is greater than largest uint88).
     *
     * Counterpart to Solidity's `uint88` operator.
     *
     * Requirements:
     *
     * - input must fit into 88 bits
     */
    function toUint88(uint256 value) internal pure returns (uint88) {
        if (value > type(uint88).max) {
            revert SafeCastOverflowedUintDowncast(88, value);
        }
        return uint88(value);
    }

    /**
     * @dev Returns the downcasted uint80 from uint256, reverting on
     * overflow (when the input is greater than largest uint80).
     *
     * Counterpart to Solidity's `uint80` operator.
     *
     * Requirements:
     *
     * - input must fit into 80 bits
     */
    function toUint80(uint256 value) internal pure returns (uint80) {
        if (value > type(uint80).max) {
            revert SafeCastOverflowedUintDowncast(80, value);
        }
        return uint80(value);
    }

    /**
     * @dev Returns the downcasted uint72 from uint256, reverting on
     * overflow (when the input is greater than largest uint72).
     *
     * Counterpart to Solidity's `uint72` operator.
     *
     * Requirements:
     *
     * - input must fit into 72 bits
     */
    function toUint72(uint256 value) internal pure returns (uint72) {
        if (value > type(uint72).max) {
            revert SafeCastOverflowedUintDowncast(72, value);
        }
        return uint72(value);
    }

    /**
     * @dev Returns the downcasted uint64 from uint256, reverting on
     * overflow (when the input is greater than largest uint64).
     *
     * Counterpart to Solidity's `uint64` operator.
     *
     * Requirements:
     *
     * - input must fit into 64 bits
     */
    function toUint64(uint256 value) internal pure returns (uint64) {
        if (value > type(uint64).max) {
            revert SafeCastOverflowedUintDowncast(64, value);
        }
        return uint64(value);
    }

    /**
     * @dev Returns the downcasted uint56 from uint256, reverting on
     * overflow (when the input is greater than largest uint56).
     *
     * Counterpart to Solidity's `uint56` operator.
     *
     * Requirements:
     *
     * - input must fit into 56 bits
     */
    function toUint56(uint256 value) internal pure returns (uint56) {
        if (value > type(uint56).max) {
            revert SafeCastOverflowedUintDowncast(56, value);
        }
        return uint56(value);
    }

    /**
     * @dev Returns the downcasted uint48 from uint256, reverting on
     * overflow (when the input is greater than largest uint48).
     *
     * Counterpart to Solidity's `uint48` operator.
     *
     * Requirements:
     *
     * - input must fit into 48 bits
     */
    function toUint48(uint256 value) internal pure returns (uint48) {
        if (value > type(uint48).max) {
            revert SafeCastOverflowedUintDowncast(48, value);
        }
        return uint48(value);
    }

    /**
     * @dev Returns the downcasted uint40 from uint256, reverting on
     * overflow (when the input is greater than largest uint40).
     *
     * Counterpart to Solidity's `uint40` operator.
     *
     * Requirements:
     *
     * - input must fit into 40 bits
     */
    function toUint40(uint256 value) internal pure returns (uint40) {
        if (value > type(uint40).max) {
            revert SafeCastOverflowedUintDowncast(40, value);
        }
        return uint40(value);
    }

    /**
     * @dev Returns the downcasted uint32 from uint256, reverting on
     * overflow (when the input is greater than largest uint32).
     *
     * Counterpart to Solidity's `uint32` operator.
     *
     * Requirements:
     *
     * - input must fit into 32 bits
     */
    function toUint32(uint256 value) internal pure returns (uint32) {
        if (value > type(uint32).max) {
            revert SafeCastOverflowedUintDowncast(32, value);
        }
        return uint32(value);
    }

    /**
     * @dev Returns the downcasted uint24 from uint256, reverting on
     * overflow (when the input is greater than largest uint24).
     *
     * Counterpart to Solidity's `uint24` operator.
     *
     * Requirements:
     *
     * - input must fit into 24 bits
     */
    function toUint24(uint256 value) internal pure returns (uint24) {
        if (value > type(uint24).max) {
            revert SafeCastOverflowedUintDowncast(24, value);
        }
        return uint24(value);
    }

    /**
     * @dev Returns the downcasted uint16 from uint256, reverting on
     * overflow (when the input is greater than largest uint16).
     *
     * Counterpart to Solidity's `uint16` operator.
     *
     * Requirements:
     *
     * - input must fit into 16 bits
     */
    function toUint16(uint256 value) internal pure returns (uint16) {
        if (value > type(uint16).max) {
            revert SafeCastOverflowedUintDowncast(16, value);
        }
        return uint16(value);
    }

    /**
     * @dev Returns the downcasted uint8 from uint256, reverting on
     * overflow (when the input is greater than largest uint8).
     *
     * Counterpart to Solidity's `uint8` operator.
     *
     * Requirements:
     *
     * - input must fit into 8 bits
     */
    function toUint8(uint256 value) internal pure returns (uint8) {
        if (value > type(uint8).max) {
            revert SafeCastOverflowedUintDowncast(8, value);
        }
        return uint8(value);
    }

    /**
     * @dev Converts a signed int256 into an unsigned uint256.
     *
     * Requirements:
     *
     * - input must be greater than or equal to 0.
     */
    function toUint256(int256 value) internal pure returns (uint256) {
        if (value < 0) {
            revert SafeCastOverflowedIntToUint(value);
        }
        return uint256(value);
    }

    /**
     * @dev Returns the downcasted int248 from int256, reverting on
     * overflow (when the input is less than smallest int248 or
     * greater than largest int248).
     *
     * Counterpart to Solidity's `int248` operator.
     *
     * Requirements:
     *
     * - input must fit into 248 bits
     */
    function toInt248(int256 value) internal pure returns (int248 downcasted) {
        downcasted = int248(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(248, value);
        }
    }

    /**
     * @dev Returns the downcasted int240 from int256, reverting on
     * overflow (when the input is less than smallest int240 or
     * greater than largest int240).
     *
     * Counterpart to Solidity's `int240` operator.
     *
     * Requirements:
     *
     * - input must fit into 240 bits
     */
    function toInt240(int256 value) internal pure returns (int240 downcasted) {
        downcasted = int240(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(240, value);
        }
    }

    /**
     * @dev Returns the downcasted int232 from int256, reverting on
     * overflow (when the input is less than smallest int232 or
     * greater than largest int232).
     *
     * Counterpart to Solidity's `int232` operator.
     *
     * Requirements:
     *
     * - input must fit into 232 bits
     */
    function toInt232(int256 value) internal pure returns (int232 downcasted) {
        downcasted = int232(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(232, value);
        }
    }

    /**
     * @dev Returns the downcasted int224 from int256, reverting on
     * overflow (when the input is less than smallest int224 or
     * greater than largest int224).
     *
     * Counterpart to Solidity's `int224` operator.
     *
     * Requirements:
     *
     * - input must fit into 224 bits
     */
    function toInt224(int256 value) internal pure returns (int224 downcasted) {
        downcasted = int224(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(224, value);
        }
    }

    /**
     * @dev Returns the downcasted int216 from int256, reverting on
     * overflow (when the input is less than smallest int216 or
     * greater than largest int216).
     *
     * Counterpart to Solidity's `int216` operator.
     *
     * Requirements:
     *
     * - input must fit into 216 bits
     */
    function toInt216(int256 value) internal pure returns (int216 downcasted) {
        downcasted = int216(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(216, value);
        }
    }

    /**
     * @dev Returns the downcasted int208 from int256, reverting on
     * overflow (when the input is less than smallest int208 or
     * greater than largest int208).
     *
     * Counterpart to Solidity's `int208` operator.
     *
     * Requirements:
     *
     * - input must fit into 208 bits
     */
    function toInt208(int256 value) internal pure returns (int208 downcasted) {
        downcasted = int208(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(208, value);
        }
    }

    /**
     * @dev Returns the downcasted int200 from int256, reverting on
     * overflow (when the input is less than smallest int200 or
     * greater than largest int200).
     *
     * Counterpart to Solidity's `int200` operator.
     *
     * Requirements:
     *
     * - input must fit into 200 bits
     */
    function toInt200(int256 value) internal pure returns (int200 downcasted) {
        downcasted = int200(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(200, value);
        }
    }

    /**
     * @dev Returns the downcasted int192 from int256, reverting on
     * overflow (when the input is less than smallest int192 or
     * greater than largest int192).
     *
     * Counterpart to Solidity's `int192` operator.
     *
     * Requirements:
     *
     * - input must fit into 192 bits
     */
    function toInt192(int256 value) internal pure returns (int192 downcasted) {
        downcasted = int192(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(192, value);
        }
    }

    /**
     * @dev Returns the downcasted int184 from int256, reverting on
     * overflow (when the input is less than smallest int184 or
     * greater than largest int184).
     *
     * Counterpart to Solidity's `int184` operator.
     *
     * Requirements:
     *
     * - input must fit into 184 bits
     */
    function toInt184(int256 value) internal pure returns (int184 downcasted) {
        downcasted = int184(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(184, value);
        }
    }

    /**
     * @dev Returns the downcasted int176 from int256, reverting on
     * overflow (when the input is less than smallest int176 or
     * greater than largest int176).
     *
     * Counterpart to Solidity's `int176` operator.
     *
     * Requirements:
     *
     * - input must fit into 176 bits
     */
    function toInt176(int256 value) internal pure returns (int176 downcasted) {
        downcasted = int176(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(176, value);
        }
    }

    /**
     * @dev Returns the downcasted int168 from int256, reverting on
     * overflow (when the input is less than smallest int168 or
     * greater than largest int168).
     *
     * Counterpart to Solidity's `int168` operator.
     *
     * Requirements:
     *
     * - input must fit into 168 bits
     */
    function toInt168(int256 value) internal pure returns (int168 downcasted) {
        downcasted = int168(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(168, value);
        }
    }

    /**
     * @dev Returns the downcasted int160 from int256, reverting on
     * overflow (when the input is less than smallest int160 or
     * greater than largest int160).
     *
     * Counterpart to Solidity's `int160` operator.
     *
     * Requirements:
     *
     * - input must fit into 160 bits
     */
    function toInt160(int256 value) internal pure returns (int160 downcasted) {
        downcasted = int160(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(160, value);
        }
    }

    /**
     * @dev Returns the downcasted int152 from int256, reverting on
     * overflow (when the input is less than smallest int152 or
     * greater than largest int152).
     *
     * Counterpart to Solidity's `int152` operator.
     *
     * Requirements:
     *
     * - input must fit into 152 bits
     */
    function toInt152(int256 value) internal pure returns (int152 downcasted) {
        downcasted = int152(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(152, value);
        }
    }

    /**
     * @dev Returns the downcasted int144 from int256, reverting on
     * overflow (when the input is less than smallest int144 or
     * greater than largest int144).
     *
     * Counterpart to Solidity's `int144` operator.
     *
     * Requirements:
     *
     * - input must fit into 144 bits
     */
    function toInt144(int256 value) internal pure returns (int144 downcasted) {
        downcasted = int144(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(144, value);
        }
    }

    /**
     * @dev Returns the downcasted int136 from int256, reverting on
     * overflow (when the input is less than smallest int136 or
     * greater than largest int136).
     *
     * Counterpart to Solidity's `int136` operator.
     *
     * Requirements:
     *
     * - input must fit into 136 bits
     */
    function toInt136(int256 value) internal pure returns (int136 downcasted) {
        downcasted = int136(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(136, value);
        }
    }

    /**
     * @dev Returns the downcasted int128 from int256, reverting on
     * overflow (when the input is less than smallest int128 or
     * greater than largest int128).
     *
     * Counterpart to Solidity's `int128` operator.
     *
     * Requirements:
     *
     * - input must fit into 128 bits
     */
    function toInt128(int256 value) internal pure returns (int128 downcasted) {
        downcasted = int128(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(128, value);
        }
    }

    /**
     * @dev Returns the downcasted int120 from int256, reverting on
     * overflow (when the input is less than smallest int120 or
     * greater than largest int120).
     *
     * Counterpart to Solidity's `int120` operator.
     *
     * Requirements:
     *
     * - input must fit into 120 bits
     */
    function toInt120(int256 value) internal pure returns (int120 downcasted) {
        downcasted = int120(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(120, value);
        }
    }

    /**
     * @dev Returns the downcasted int112 from int256, reverting on
     * overflow (when the input is less than smallest int112 or
     * greater than largest int112).
     *
     * Counterpart to Solidity's `int112` operator.
     *
     * Requirements:
     *
     * - input must fit into 112 bits
     */
    function toInt112(int256 value) internal pure returns (int112 downcasted) {
        downcasted = int112(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(112, value);
        }
    }

    /**
     * @dev Returns the downcasted int104 from int256, reverting on
     * overflow (when the input is less than smallest int104 or
     * greater than largest int104).
     *
     * Counterpart to Solidity's `int104` operator.
     *
     * Requirements:
     *
     * - input must fit into 104 bits
     */
    function toInt104(int256 value) internal pure returns (int104 downcasted) {
        downcasted = int104(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(104, value);
        }
    }

    /**
     * @dev Returns the downcasted int96 from int256, reverting on
     * overflow (when the input is less than smallest int96 or
     * greater than largest int96).
     *
     * Counterpart to Solidity's `int96` operator.
     *
     * Requirements:
     *
     * - input must fit into 96 bits
     */
    function toInt96(int256 value) internal pure returns (int96 downcasted) {
        downcasted = int96(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(96, value);
        }
    }

    /**
     * @dev Returns the downcasted int88 from int256, reverting on
     * overflow (when the input is less than smallest int88 or
     * greater than largest int88).
     *
     * Counterpart to Solidity's `int88` operator.
     *
     * Requirements:
     *
     * - input must fit into 88 bits
     */
    function toInt88(int256 value) internal pure returns (int88 downcasted) {
        downcasted = int88(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(88, value);
        }
    }

    /**
     * @dev Returns the downcasted int80 from int256, reverting on
     * overflow (when the input is less than smallest int80 or
     * greater than largest int80).
     *
     * Counterpart to Solidity's `int80` operator.
     *
     * Requirements:
     *
     * - input must fit into 80 bits
     */
    function toInt80(int256 value) internal pure returns (int80 downcasted) {
        downcasted = int80(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(80, value);
        }
    }

    /**
     * @dev Returns the downcasted int72 from int256, reverting on
     * overflow (when the input is less than smallest int72 or
     * greater than largest int72).
     *
     * Counterpart to Solidity's `int72` operator.
     *
     * Requirements:
     *
     * - input must fit into 72 bits
     */
    function toInt72(int256 value) internal pure returns (int72 downcasted) {
        downcasted = int72(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(72, value);
        }
    }

    /**
     * @dev Returns the downcasted int64 from int256, reverting on
     * overflow (when the input is less than smallest int64 or
     * greater than largest int64).
     *
     * Counterpart to Solidity's `int64` operator.
     *
     * Requirements:
     *
     * - input must fit into 64 bits
     */
    function toInt64(int256 value) internal pure returns (int64 downcasted) {
        downcasted = int64(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(64, value);
        }
    }

    /**
     * @dev Returns the downcasted int56 from int256, reverting on
     * overflow (when the input is less than smallest int56 or
     * greater than largest int56).
     *
     * Counterpart to Solidity's `int56` operator.
     *
     * Requirements:
     *
     * - input must fit into 56 bits
     */
    function toInt56(int256 value) internal pure returns (int56 downcasted) {
        downcasted = int56(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(56, value);
        }
    }

    /**
     * @dev Returns the downcasted int48 from int256, reverting on
     * overflow (when the input is less than smallest int48 or
     * greater than largest int48).
     *
     * Counterpart to Solidity's `int48` operator.
     *
     * Requirements:
     *
     * - input must fit into 48 bits
     */
    function toInt48(int256 value) internal pure returns (int48 downcasted) {
        downcasted = int48(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(48, value);
        }
    }

    /**
     * @dev Returns the downcasted int40 from int256, reverting on
     * overflow (when the input is less than smallest int40 or
     * greater than largest int40).
     *
     * Counterpart to Solidity's `int40` operator.
     *
     * Requirements:
     *
     * - input must fit into 40 bits
     */
    function toInt40(int256 value) internal pure returns (int40 downcasted) {
        downcasted = int40(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(40, value);
        }
    }

    /**
     * @dev Returns the downcasted int32 from int256, reverting on
     * overflow (when the input is less than smallest int32 or
     * greater than largest int32).
     *
     * Counterpart to Solidity's `int32` operator.
     *
     * Requirements:
     *
     * - input must fit into 32 bits
     */
    function toInt32(int256 value) internal pure returns (int32 downcasted) {
        downcasted = int32(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(32, value);
        }
    }

    /**
     * @dev Returns the downcasted int24 from int256, reverting on
     * overflow (when the input is less than smallest int24 or
     * greater than largest int24).
     *
     * Counterpart to Solidity's `int24` operator.
     *
     * Requirements:
     *
     * - input must fit into 24 bits
     */
    function toInt24(int256 value) internal pure returns (int24 downcasted) {
        downcasted = int24(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(24, value);
        }
    }

    /**
     * @dev Returns the downcasted int16 from int256, reverting on
     * overflow (when the input is less than smallest int16 or
     * greater than largest int16).
     *
     * Counterpart to Solidity's `int16` operator.
     *
     * Requirements:
     *
     * - input must fit into 16 bits
     */
    function toInt16(int256 value) internal pure returns (int16 downcasted) {
        downcasted = int16(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(16, value);
        }
    }

    /**
     * @dev Returns the downcasted int8 from int256, reverting on
     * overflow (when the input is less than smallest int8 or
     * greater than largest int8).
     *
     * Counterpart to Solidity's `int8` operator.
     *
     * Requirements:
     *
     * - input must fit into 8 bits
     */
    function toInt8(int256 value) internal pure returns (int8 downcasted) {
        downcasted = int8(value);
        if (downcasted != value) {
            revert SafeCastOverflowedIntDowncast(8, value);
        }
    }

    /**
     * @dev Converts an unsigned uint256 into a signed int256.
     *
     * Requirements:
     *
     * - input must be less than or equal to maxInt256.
     */
    function toInt256(uint256 value) internal pure returns (int256) {
        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
        if (value > uint256(type(int256).max)) {
            revert SafeCastOverflowedUintToInt(value);
        }
        return int256(value);
    }

    /**
     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.
     */
    function toUint(bool b) internal pure returns (uint256 u) {
        assembly ("memory-safe") {
            u := iszero(iszero(b))
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.3.0) (utils/TransientSlot.sol)
// This file was procedurally generated from scripts/generate/templates/TransientSlot.js.

pragma solidity ^0.8.24;

/**
 * @dev Library for reading and writing value-types to specific transient storage slots.
 *
 * Transient slots are often used to store temporary values that are removed after the current transaction.
 * This library helps with reading and writing to such slots without the need for inline assembly.
 *
 *  * Example reading and writing values using transient storage:
 * ```solidity
 * contract Lock {
 *     using TransientSlot for *;
 *
 *     // Define the slot. Alternatively, use the SlotDerivation library to derive the slot.
 *     bytes32 internal constant _LOCK_SLOT = 0xf4678858b2b588224636b8522b729e7722d32fc491da849ed75b3fdf3c84f542;
 *
 *     modifier locked() {
 *         require(!_LOCK_SLOT.asBoolean().tload());
 *
 *         _LOCK_SLOT.asBoolean().tstore(true);
 *         _;
 *         _LOCK_SLOT.asBoolean().tstore(false);
 *     }
 * }
 * ```
 *
 * TIP: Consider using this library along with {SlotDerivation}.
 */
library TransientSlot {
    /**
     * @dev UDVT that represents a slot holding an address.
     */
    type AddressSlot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a AddressSlot.
     */
    function asAddress(bytes32 slot) internal pure returns (AddressSlot) {
        return AddressSlot.wrap(slot);
    }

    /**
     * @dev UDVT that represents a slot holding a bool.
     */
    type BooleanSlot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a BooleanSlot.
     */
    function asBoolean(bytes32 slot) internal pure returns (BooleanSlot) {
        return BooleanSlot.wrap(slot);
    }

    /**
     * @dev UDVT that represents a slot holding a bytes32.
     */
    type Bytes32Slot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a Bytes32Slot.
     */
    function asBytes32(bytes32 slot) internal pure returns (Bytes32Slot) {
        return Bytes32Slot.wrap(slot);
    }

    /**
     * @dev UDVT that represents a slot holding a uint256.
     */
    type Uint256Slot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a Uint256Slot.
     */
    function asUint256(bytes32 slot) internal pure returns (Uint256Slot) {
        return Uint256Slot.wrap(slot);
    }

    /**
     * @dev UDVT that represents a slot holding a int256.
     */
    type Int256Slot is bytes32;

    /**
     * @dev Cast an arbitrary slot to a Int256Slot.
     */
    function asInt256(bytes32 slot) internal pure returns (Int256Slot) {
        return Int256Slot.wrap(slot);
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(AddressSlot slot) internal view returns (address value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(AddressSlot slot, address value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(BooleanSlot slot) internal view returns (bool value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(BooleanSlot slot, bool value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(Bytes32Slot slot) internal view returns (bytes32 value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(Bytes32Slot slot, bytes32 value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(Uint256Slot slot) internal view returns (uint256 value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(Uint256Slot slot, uint256 value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }

    /**
     * @dev Load the value held at location `slot` in transient storage.
     */
    function tload(Int256Slot slot) internal view returns (int256 value) {
        assembly ("memory-safe") {
            value := tload(slot)
        }
    }

    /**
     * @dev Store `value` at location `slot` in transient storage.
     */
    function tstore(Int256Slot slot, int256 value) internal {
        assembly ("memory-safe") {
            tstore(slot, value)
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC20Metadata.sol)

pragma solidity >=0.6.2;

import {IERC20Metadata} from "../token/ERC20/extensions/IERC20Metadata.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC165.sol)

pragma solidity >=0.4.16;

import {IERC165} from "../utils/introspection/IERC165.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (utils/introspection/IERC165.sol)

pragma solidity >=0.4.16;

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

{
  "remappings": [
    "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/",
    "@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/",
    "erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/",
    "forge-std/=lib/forge-std/src/",
    "halmos-cheatcodes/=lib/openzeppelin-contracts-upgradeable/lib/halmos-cheatcodes/src/",
    "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/",
    "openzeppelin-contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/",
    "openzeppelin-foundry-upgrades/=lib/openzeppelin-foundry-upgrades/src/"
  ],
  "optimizer": {
    "enabled": true,
    "runs": 10000
  },
  "metadata": {
    "useLiteralContent": false,
    "bytecodeHash": "none",
    "appendCBOR": true
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "evmVersion": "prague",
  "viaIR": true
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"contract IERC20","name":"asset_","type":"address"},{"internalType":"contract IController","name":"controller_","type":"address"},{"internalType":"contract IERC4626","name":"strategy_","type":"address"},{"internalType":"address","name":"manager_","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AssetDecimalsTooHigh","type":"error"},{"inputs":[],"name":"CallerNotController","type":"error"},{"inputs":[],"name":"CallerNotManager","type":"error"},{"inputs":[],"name":"MismatchedAsset","type":"error"},{"inputs":[],"name":"NoDecimals","type":"error"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"inputs":[],"name":"ZeroAsset","type":"error"},{"inputs":[],"name":"ZeroAssetsOrShares","type":"error"},{"inputs":[],"name":"ZeroController","type":"error"},{"inputs":[],"name":"ZeroStrategy","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"strategy","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"}],"name":"Allocate","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"}],"name":"ControllerDeposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"asset","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"}],"name":"ControllerWithdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"strategy","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"}],"name":"Deallocate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"threshold","type":"uint256"}],"name":"SetAutoAllocationThreshold","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"assets","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"shares","type":"uint256"}],"name":"Withdraw","type":"event"},{"inputs":[],"name":"NORMALIZED_ASSET_DECIMALS","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"allocate","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"asset","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"autoAllocationThreshold","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"controller","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"controllerDeposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"asset_","type":"address"},{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"controllerWithdraw","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":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"deallocate","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"deposit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"manager","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"maxDeposit","outputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"maxMint","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxRedeem","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"maxWithdraw","outputs":[{"internalType":"uint256","name":"assets","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":"assets","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"}],"name":"previewDeposit","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"name":"previewMint","outputs":[{"internalType":"uint256","name":"assets","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":"threshold","type":"uint256"}],"name":"setAutoAllocationThreshold","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"share","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"strategy","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalNormalizedAssets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"assets","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"withdraw","outputs":[{"internalType":"uint256","name":"shares","type":"uint256"}],"stateMutability":"nonpayable","type":"function"}]

0x610120806040523461031e5760808161217c80380380916100208285610394565b83398101031261031e5780516001600160a01b0381169081810361031e5760208301516001600160a01b038116929083810361031e5760408501516001600160a01b0381169590939086850361031e57606061007c91016103cb565b948315610385571561037657610098918160805260a0526103df565b90156103675760ff16601281116103585760120360ff81116103445760c0528315610335576040516338d52e0f60e01b8152602081600481885afa90811561032a575f916102ec575b506001600160a01b0316036102dd5760e0526101005260018060a01b03608051166040519060205f81840163095ea7b360e01b81528560248601528119604486015260448552610132606486610394565b84519082855af15f513d826102c1575b50501561027c575b604051611c9290816104ea8239608051818181610317015281816110bc0152818161135b015281816116910152818161198401528181611a240152611b39015260a05181818161024c015281816102b401528181610427015281816105660152818161061b0152818161072f015281816107f2015281816108c1015281816109ff01528181610ac401528181610b7901528181610cb701528181610ea901528181610f6b0152818161104601526111cd015260c0518181816103bf015281816104e9015281816106ad0152818161097801528181610e280152818161116d015281816114fc015261155d015260e051818181610c1e0152818161139601528181611778015281816118880152611a92015261010051818181610d4c01528181610dc201528181610fc401526110fe0152f35b6102b46102b9936040519063095ea7b360e01b602083015260248201525f6044820152604481526102ae606482610394565b82610491565b610491565b5f808061014a565b9091506102d55750803b15155b5f80610142565b6001146102ce565b6364ab3bb760e11b5f5260045ffd5b90506020813d602011610322575b8161030760209383610394565b8101031261031e57610318906103cb565b5f6100e1565b5f80fd5b3d91506102fa565b6040513d5f823e3d90fd5b63442aad0560e01b5f5260045ffd5b634e487b7160e01b5f52601160045260245ffd5b6310b55d3f60e01b5f5260045ffd5b632ee01ac960e11b5f5260045ffd5b632f62e27560e01b5f5260045ffd5b633e6f4db960e11b5f5260045ffd5b601f909101601f19168101906001600160401b038211908210176103b757604052565b634e487b7160e01b5f52604160045260245ffd5b51906001600160a01b038216820361031e57565b5f8091604051602081019063313ce56760e01b825260048152610403602482610394565b51916001600160a01b03165afa3d15610489573d906001600160401b0382116103b7576040519161043e601f8201601f191660200184610394565b82523d5f602084013e5b8061047d575b61045a575b505f905f90565b60208180518101031261031e576020015160ff8111610453579060ff6001921690565b5060208151101561044e565b606090610448565b905f602091828151910182855af11561032a575f513d6104e057506001600160a01b0381163b155b6104c05750565b635274afe760e01b5f9081526001600160a01b0391909116600452602490fd5b600114156104b956fe60806040526004361015610011575f80fd5b5f3560e01c806301e1d1141461122457806307a2d13a146112065780630a28a477146111545780632973e760146110e057806338d52e0f1461109d578063395202d614611080578063402d267d14610fe8578063481c6a7514610fa55780634cdad50614610f1c5780636e553f6514610df55780636f6c441f14610da757806390ca796b14610d3157806394bf804d14610c42578063a8c62e7614610bff578063a8d5fd6514610b33578063b3d7f6b914610a75578063b460af9414610950578063b9c25d191461089b578063ba08765214610783578063c4e0fc1614610768578063c63d75b6146106d1578063c6e6f59214610692578063ce96cb771461059f578063d905777e146104bb578063ee77e8911461049f578063ef8b30f7146103a6578063f6a8288314610270578063f77c47911461022d5763ffa1ad7414610158575f80fd5b34610229575f600319360112610229576040516040810181811067ffffffffffffffff8211176101fc5760405260038152604060208201917f312e30000000000000000000000000000000000000000000000000000000000083527fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8351948593602085525180918160208701528686015e5f85828601015201168101030190f35b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b5f80fd5b34610229575f6003193601126102295760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346102295760606003193601126102295761028961123e565b602435604435906001600160a01b03821692838303610229576102aa6115b4565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016330361037e57816103447f8ffac930f47e1fda46d22d098b94996a6b12680a41c8c731ebea5f1445f4e11a936001600160a01b0360209416956001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168714610370575b86611bbc565b604051908152a35f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d005b61037982611afd565b61033e565b7f2d5fb10f000000000000000000000000000000000000000000000000000000005f5260045ffd5b34610229576020600319360112610229576103eb6103e37f00000000000000000000000000000000000000000000000000000000000000006114e6565b6004356115a1565b604051907fef8b30f700000000000000000000000000000000000000000000000000000000825260048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa8015610494575f90610461575b602090604051908152f35b506020813d60201161048c575b8161047b602093836112a4565b810103126102295760209051610456565b3d915061046e565b6040513d5f823e3d90fd5b34610229575f6003193601126102295760205f54604051908152f35b346102295760206003193601126102295761055a60206104d961123e565b6105136104e46119e8565b61050d7f00000000000000000000000000000000000000000000000000000000000000006114e6565b906115a1565b6040517f4abe41370000000000000000000000000000000000000000000000000000000081526001600160a01b039092166004830152602482015291829081906044820190565b03816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa8015610494575f9061046157602090604051908152f35b346102295760206003193601126102295761060f60206105bd61123e565b6105c86104e46119e8565b6040517f85b687560000000000000000000000000000000000000000000000000000000081526001600160a01b039092166004830152602482015291829081906044820190565b03816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f9161065e575b6020610656836114f7565b604051908152f35b90506020813d60201161068a575b81610679602093836112a4565b81010312610229575161065661064b565b3d915061066c565b346102295760206003193601126102295760206106566103e37f00000000000000000000000000000000000000000000000000000000000000006114e6565b34610229576020600319360112610229576106ea61123e565b6001600160a01b03604051917fc63d75b60000000000000000000000000000000000000000000000000000000083521660048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa8015610494575f9061046157602090604051908152f35b34610229575f60031936011261022957602060405160128152f35b34610229576107913661126a565b909161079b6115b4565b6040517fba087652000000000000000000000000000000000000000000000000000000008152600481018290523360248201526001600160a01b0383166044820152602081806064810103815f6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1908115610494575f91610866575b509060209361083361083b936114f7565b93849161195a565b5f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d604051908152f35b9190506020823d602011610893575b81610882602093836112a4565b810103126102295790516020610822565b3d9150610875565b34610229576020600319360112610229576004356108b76115b4565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016330361037e5760207fee3883de1baed0df4cddcd65b9a8f85f97f49c470d2d53c3f73021c31f7bd638915f54811015610941575b604051908152a15f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d005b61094a8161184b565b50610915565b34610229576109f26109613661126a565b9061096d9392936115b4565b6020826109a261099c7f00000000000000000000000000000000000000000000000000000000000000006114e6565b876115a1565b6040517fb460af9400000000000000000000000000000000000000000000000000000000815260048101919091523360248201526001600160a01b03909116604482015293849081906064820190565b03815f6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1928315610494575f93610a3e575b5060209361083b92849261195a565b9192506020823d602011610a6d575b81610a5a602093836112a4565b8101031261022957905191906020610a2f565b3d9150610a4d565b34610229576020600319360112610229576040517fb3d7f6b900000000000000000000000000000000000000000000000000000000815260043560048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f91610aff575b602061065683611558565b90506020813d602011610b2b575b81610b1a602093836112a4565b810103126102295751610656610af4565b3d9150610b0d565b34610229575f600319360112610229576040517fa8d5fd650000000000000000000000000000000000000000000000000000000081526020816004816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa8015610494575f90610bbc575b6020906001600160a01b0360405191168152f35b506020813d602011610bf7575b81610bd6602093836112a4565b8101031261022957516001600160a01b038116810361022957602090610ba8565b3d9150610bc9565b34610229575f6003193601126102295760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b3461022957604060031936011261022957600435610c5e611254565b610c666115b4565b6040517f94bf804d000000000000000000000000000000000000000000000000000000008152600481018390526001600160a01b0382166024820152602081806044810103815f6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1908115610494575f91610cfe575b50602092610cf761083b92611558565b8093611628565b90506020813d602011610d29575b81610d19602093836112a4565b8101031261022957516020610ce7565b3d9150610d0c565b34610229576020600319360112610229576001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163303610d7f57602061065660043561184b565b7fc4230ae3000000000000000000000000000000000000000000000000000000005f5260045ffd5b34610229576020600319360112610229576001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163303610d7f576020610656600435611734565b3461022957604060031936011261022957600435610e9c610e14611254565b91610e1d6115b4565b602083610e52610e4c7f00000000000000000000000000000000000000000000000000000000000000006114e6565b846115a1565b60405194859283927f6e553f65000000000000000000000000000000000000000000000000000000008452600484019092916001600160a01b036020916040840195845216910152565b03815f6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1918215610494575f92610ee7575b508161083b91602094611628565b9091506020813d602011610f14575b81610f03602093836112a4565b810103126102295751906020610ed9565b3d9150610ef6565b34610229576020600319360112610229576040517f4cdad50600000000000000000000000000000000000000000000000000000000815260043560048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f9161065e576020610656836114f7565b34610229575f6003193601126102295760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346102295760206003193601126102295761100161123e565b6001600160a01b03604051917f402d267d0000000000000000000000000000000000000000000000000000000083521660048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f9161065e576020610656836114f7565b34610229575f6003193601126102295760206106566104e461131f565b34610229575f6003193601126102295760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b34610229576020600319360112610229576004356001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163303610d7f576020817f85ea118111759b07a83fcb2ee7900d0db2396f5fe7d048be7759387504b8680c925f55604051908152a1005b34610229576020600319360112610229576111916103e37f00000000000000000000000000000000000000000000000000000000000000006114e6565b604051907f0a28a47700000000000000000000000000000000000000000000000000000000825260048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa8015610494575f9061046157602090604051908152f35b346102295760206003193601126102295760206106566004356114f7565b34610229575f60031936011261022957602061065661131f565b600435906001600160a01b038216820361022957565b602435906001600160a01b038216820361022957565b600319606091011261022957600435906024356001600160a01b038116810361022957906044356001600160a01b03811681036102295790565b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff8211176101fc57604052565b919082018092116112f257565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b6040517f70a082310000000000000000000000000000000000000000000000000000000081523060048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f916114b4575b506001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906040517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152602081602481865afa8015610494575f90611481575b602091506024604051809581937f07a2d13a00000000000000000000000000000000000000000000000000000000835260048301525afa908115610494575f9161144b575b61144892506112e5565b90565b90506020823d602011611479575b81611466602093836112a4565b810103126102295761144891519061143e565b3d9150611459565b506020813d6020116114ac575b8161149b602093836112a4565b8101031261022957602090516113f9565b3d915061148e565b90506020813d6020116114de575b816114cf602093836112a4565b8101031261022957515f61138b565b3d91506114c2565b60ff16604d81116112f257600a0a90565b6115207f00000000000000000000000000000000000000000000000000000000000000006114e6565b90811561152b570490565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b6115817f00000000000000000000000000000000000000000000000000000000000000006114e6565b801561152b5780820491066115935790565b600181018091116112f25790565b818102929181159184041417156112f257565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005c6116005760017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d565b7f3ee5aeb5000000000000000000000000000000000000000000000000000000005f5260045ffd5b9190918215158061172b575b15611703576001600160a01b03916116b56040517f23b872dd0000000000000000000000000000000000000000000000000000000060208201523360248201523060448201528560648201526064815261168f6084826112a4565b7f0000000000000000000000000000000000000000000000000000000000000000611c18565b5f548410156116f4575b604051938452602084015216907fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d760403392a3565b6116fd8461184b565b506116bf565b7f52e88df3000000000000000000000000000000000000000000000000000000005f5260045ffd5b50811515611634565b6040517fb460af9400000000000000000000000000000000000000000000000000000000815260048101829052306024820181905260448201526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001692916020826064815f885af18015610494575f906117f9575b604080516001600160a01b0390961686526020860192909252937fd338c9f6c5eed79757e45cc8cc8b14bce8f5413e34e2dbbe362bc914bf6c439b925090819081015b0390a1565b506020823d602011611843575b81611813602093836112a4565b81010312610229577fd338c9f6c5eed79757e45cc8cc8b14bce8f5413e34e2dbbe362bc914bf6c439b91516117b1565b3d9150611806565b6040517f6e553f65000000000000000000000000000000000000000000000000000000008152600481018290523060248201526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001692916020826044815f885af18015610494575f90611908575b604080516001600160a01b0390961686526020860192909252937f249d8eb76d5a22983620d741de2470148d1a9a26ab923aec4262770690d11ebc925090819081016117f4565b506020823d602011611952575b81611922602093836112a4565b81010312610229577f249d8eb76d5a22983620d741de2470148d1a9a26ab923aec4262770690d11ebc91516118c1565b3d9150611915565b92821515806119df575b15611703576001600160a01b0391829161197d85611afd565b6119a885877f0000000000000000000000000000000000000000000000000000000000000000611bbc565b6040519485526020850152169216907ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db60403392a4565b50801515611964565b6040517f70a082310000000000000000000000000000000000000000000000000000000081523060048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f91611acb575b50604051907fce96cb770000000000000000000000000000000000000000000000000000000082523060048301526020826024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f9161144b5761144892506112e5565b90506020813d602011611af5575b81611ae6602093836112a4565b8101031261022957515f611a54565b3d9150611ad9565b6040517f70a082310000000000000000000000000000000000000000000000000000000081523060048201526020816024816001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165afa908115610494575f91611b8a575b50808211611b75575050565b81039081116112f257611b8790611734565b50565b90506020813d602011611bb4575b81611ba5602093836112a4565b8101031261022957515f611b69565b3d9150611b98565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b03929092166024830152604480830193909352918152611c1691611c116064836112a4565b611c18565b565b905f602091828151910182855af115610494575f513d611c7c57506001600160a01b0381163b155b611c475750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b60011415611c4056fea164736f6c634300081d000a000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae000000000000000000000000beef047a543e45807105e51a8bbefcc5950fcfba0000000000000000000000003794d7f91b3dd3b338fee671ac6aa42bea5e3d17

0x60806040526004361015610011575f80fd5b5f3560e01c806301e1d1141461122457806307a2d13a146112065780630a28a477146111545780632973e760146110e057806338d52e0f1461109d578063395202d614611080578063402d267d14610fe8578063481c6a7514610fa55780634cdad50614610f1c5780636e553f6514610df55780636f6c441f14610da757806390ca796b14610d3157806394bf804d14610c42578063a8c62e7614610bff578063a8d5fd6514610b33578063b3d7f6b914610a75578063b460af9414610950578063b9c25d191461089b578063ba08765214610783578063c4e0fc1614610768578063c63d75b6146106d1578063c6e6f59214610692578063ce96cb771461059f578063d905777e146104bb578063ee77e8911461049f578063ef8b30f7146103a6578063f6a8288314610270578063f77c47911461022d5763ffa1ad7414610158575f80fd5b34610229575f600319360112610229576040516040810181811067ffffffffffffffff8211176101fc5760405260038152604060208201917f312e30000000000000000000000000000000000000000000000000000000000083527fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f8351948593602085525180918160208701528686015e5f85828601015201168101030190f35b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b5f80fd5b34610229575f6003193601126102295760206040516001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae168152f35b346102295760606003193601126102295761028961123e565b602435604435906001600160a01b03821692838303610229576102aa6115b4565b6001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae16330361037e57816103447f8ffac930f47e1fda46d22d098b94996a6b12680a41c8c731ebea5f1445f4e11a936001600160a01b0360209416956001600160a01b037f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7168714610370575b86611bbc565b604051908152a35f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d005b61037982611afd565b61033e565b7f2d5fb10f000000000000000000000000000000000000000000000000000000005f5260045ffd5b34610229576020600319360112610229576103eb6103e37f000000000000000000000000000000000000000000000000000000000000000c6114e6565b6004356115a1565b604051907fef8b30f700000000000000000000000000000000000000000000000000000000825260048201526020816024816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa8015610494575f90610461575b602090604051908152f35b506020813d60201161048c575b8161047b602093836112a4565b810103126102295760209051610456565b3d915061046e565b6040513d5f823e3d90fd5b34610229575f6003193601126102295760205f54604051908152f35b346102295760206003193601126102295761055a60206104d961123e565b6105136104e46119e8565b61050d7f000000000000000000000000000000000000000000000000000000000000000c6114e6565b906115a1565b6040517f4abe41370000000000000000000000000000000000000000000000000000000081526001600160a01b039092166004830152602482015291829081906044820190565b03816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa8015610494575f9061046157602090604051908152f35b346102295760206003193601126102295761060f60206105bd61123e565b6105c86104e46119e8565b6040517f85b687560000000000000000000000000000000000000000000000000000000081526001600160a01b039092166004830152602482015291829081906044820190565b03816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa908115610494575f9161065e575b6020610656836114f7565b604051908152f35b90506020813d60201161068a575b81610679602093836112a4565b81010312610229575161065661064b565b3d915061066c565b346102295760206003193601126102295760206106566103e37f000000000000000000000000000000000000000000000000000000000000000c6114e6565b34610229576020600319360112610229576106ea61123e565b6001600160a01b03604051917fc63d75b60000000000000000000000000000000000000000000000000000000083521660048201526020816024816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa8015610494575f9061046157602090604051908152f35b34610229575f60031936011261022957602060405160128152f35b34610229576107913661126a565b909161079b6115b4565b6040517fba087652000000000000000000000000000000000000000000000000000000008152600481018290523360248201526001600160a01b0383166044820152602081806064810103815f6001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165af1908115610494575f91610866575b509060209361083361083b936114f7565b93849161195a565b5f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d604051908152f35b9190506020823d602011610893575b81610882602093836112a4565b810103126102295790516020610822565b3d9150610875565b34610229576020600319360112610229576004356108b76115b4565b6001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae16330361037e5760207fee3883de1baed0df4cddcd65b9a8f85f97f49c470d2d53c3f73021c31f7bd638915f54811015610941575b604051908152a15f7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d005b61094a8161184b565b50610915565b34610229576109f26109613661126a565b9061096d9392936115b4565b6020826109a261099c7f000000000000000000000000000000000000000000000000000000000000000c6114e6565b876115a1565b6040517fb460af9400000000000000000000000000000000000000000000000000000000815260048101919091523360248201526001600160a01b03909116604482015293849081906064820190565b03815f6001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165af1928315610494575f93610a3e575b5060209361083b92849261195a565b9192506020823d602011610a6d575b81610a5a602093836112a4565b8101031261022957905191906020610a2f565b3d9150610a4d565b34610229576020600319360112610229576040517fb3d7f6b900000000000000000000000000000000000000000000000000000000815260043560048201526020816024816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa908115610494575f91610aff575b602061065683611558565b90506020813d602011610b2b575b81610b1a602093836112a4565b810103126102295751610656610af4565b3d9150610b0d565b34610229575f600319360112610229576040517fa8d5fd650000000000000000000000000000000000000000000000000000000081526020816004816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa8015610494575f90610bbc575b6020906001600160a01b0360405191168152f35b506020813d602011610bf7575b81610bd6602093836112a4565b8101031261022957516001600160a01b038116810361022957602090610ba8565b3d9150610bc9565b34610229575f6003193601126102295760206040516001600160a01b037f000000000000000000000000beef047a543e45807105e51a8bbefcc5950fcfba168152f35b3461022957604060031936011261022957600435610c5e611254565b610c666115b4565b6040517f94bf804d000000000000000000000000000000000000000000000000000000008152600481018390526001600160a01b0382166024820152602081806044810103815f6001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165af1908115610494575f91610cfe575b50602092610cf761083b92611558565b8093611628565b90506020813d602011610d29575b81610d19602093836112a4565b8101031261022957516020610ce7565b3d9150610d0c565b34610229576020600319360112610229576001600160a01b037f0000000000000000000000003794d7f91b3dd3b338fee671ac6aa42bea5e3d17163303610d7f57602061065660043561184b565b7fc4230ae3000000000000000000000000000000000000000000000000000000005f5260045ffd5b34610229576020600319360112610229576001600160a01b037f0000000000000000000000003794d7f91b3dd3b338fee671ac6aa42bea5e3d17163303610d7f576020610656600435611734565b3461022957604060031936011261022957600435610e9c610e14611254565b91610e1d6115b4565b602083610e52610e4c7f000000000000000000000000000000000000000000000000000000000000000c6114e6565b846115a1565b60405194859283927f6e553f65000000000000000000000000000000000000000000000000000000008452600484019092916001600160a01b036020916040840195845216910152565b03815f6001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165af1918215610494575f92610ee7575b508161083b91602094611628565b9091506020813d602011610f14575b81610f03602093836112a4565b810103126102295751906020610ed9565b3d9150610ef6565b34610229576020600319360112610229576040517f4cdad50600000000000000000000000000000000000000000000000000000000815260043560048201526020816024816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa908115610494575f9161065e576020610656836114f7565b34610229575f6003193601126102295760206040516001600160a01b037f0000000000000000000000003794d7f91b3dd3b338fee671ac6aa42bea5e3d17168152f35b346102295760206003193601126102295761100161123e565b6001600160a01b03604051917f402d267d0000000000000000000000000000000000000000000000000000000083521660048201526020816024816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa908115610494575f9161065e576020610656836114f7565b34610229575f6003193601126102295760206106566104e461131f565b34610229575f6003193601126102295760206040516001600160a01b037f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7168152f35b34610229576020600319360112610229576004356001600160a01b037f0000000000000000000000003794d7f91b3dd3b338fee671ac6aa42bea5e3d17163303610d7f576020817f85ea118111759b07a83fcb2ee7900d0db2396f5fe7d048be7759387504b8680c925f55604051908152a1005b34610229576020600319360112610229576111916103e37f000000000000000000000000000000000000000000000000000000000000000c6114e6565b604051907f0a28a47700000000000000000000000000000000000000000000000000000000825260048201526020816024816001600160a01b037f0000000000000000000000003a64d23313e1beaaba25ec13149bd8d514c973ae165afa8015610494575f9061046157602090604051908152f35b346102295760206003193601126102295760206106566004356114f7565b34610229575f60031936011261022957602061065661131f565b600435906001600160a01b038216820361022957565b602435906001600160a01b038216820361022957565b600319606091011261022957600435906024356001600160a01b038116810361022957906044356001600160a01b03811681036102295790565b90601f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0910116810190811067ffffffffffffffff8211176101fc57604052565b919082018092116112f257565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b6040517f70a082310000000000000000000000000000000000000000000000000000000081523060048201526020816024816001600160a01b037f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7165afa908115610494575f916114b4575b506001600160a01b037f000000000000000000000000beef047a543e45807105e51a8bbefcc5950fcfba16906040517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152602081602481865afa8015610494575f90611481575b602091506024604051809581937f07a2d13a00000000000000000000000000000000000000000000000000000000835260048301525afa908115610494575f9161144b575b61144892506112e5565b90565b90506020823d602011611479575b81611466602093836112a4565b810103126102295761144891519061143e565b3d9150611459565b506020813d6020116114ac575b8161149b602093836112a4565b8101031261022957602090516113f9565b3d915061148e565b90506020813d6020116114de575b816114cf602093836112a4565b8101031261022957515f61138b565b3d91506114c2565b60ff16604d81116112f257600a0a90565b6115207f000000000000000000000000000000000000000000000000000000000000000c6114e6565b90811561152b570490565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b6115817f000000000000000000000000000000000000000000000000000000000000000c6114e6565b801561152b5780820491066115935790565b600181018091116112f25790565b818102929181159184041417156112f257565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005c6116005760017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f005d565b7f3ee5aeb5000000000000000000000000000000000000000000000000000000005f5260045ffd5b9190918215158061172b575b15611703576001600160a01b03916116b56040517f23b872dd0000000000000000000000000000000000000000000000000000000060208201523360248201523060448201528560648201526064815261168f6084826112a4565b7f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7611c18565b5f548410156116f4575b604051938452602084015216907fdcbc1c05240f31ff3ad067ef1ee35ce4997762752e3a095284754544f4c709d760403392a3565b6116fd8461184b565b506116bf565b7f52e88df3000000000000000000000000000000000000000000000000000000005f5260045ffd5b50811515611634565b6040517fb460af9400000000000000000000000000000000000000000000000000000000815260048101829052306024820181905260448201526001600160a01b037f000000000000000000000000beef047a543e45807105e51a8bbefcc5950fcfba1692916020826064815f885af18015610494575f906117f9575b604080516001600160a01b0390961686526020860192909252937fd338c9f6c5eed79757e45cc8cc8b14bce8f5413e34e2dbbe362bc914bf6c439b925090819081015b0390a1565b506020823d602011611843575b81611813602093836112a4565b81010312610229577fd338c9f6c5eed79757e45cc8cc8b14bce8f5413e34e2dbbe362bc914bf6c439b91516117b1565b3d9150611806565b6040517f6e553f65000000000000000000000000000000000000000000000000000000008152600481018290523060248201526001600160a01b037f000000000000000000000000beef047a543e45807105e51a8bbefcc5950fcfba1692916020826044815f885af18015610494575f90611908575b604080516001600160a01b0390961686526020860192909252937f249d8eb76d5a22983620d741de2470148d1a9a26ab923aec4262770690d11ebc925090819081016117f4565b506020823d602011611952575b81611922602093836112a4565b81010312610229577f249d8eb76d5a22983620d741de2470148d1a9a26ab923aec4262770690d11ebc91516118c1565b3d9150611915565b92821515806119df575b15611703576001600160a01b0391829161197d85611afd565b6119a885877f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7611bbc565b6040519485526020850152169216907ffbde797d201c681b91056529119e0b02407c7bb96a4a2c75c01fc9667232c8db60403392a4565b50801515611964565b6040517f70a082310000000000000000000000000000000000000000000000000000000081523060048201526020816024816001600160a01b037f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7165afa908115610494575f91611acb575b50604051907fce96cb770000000000000000000000000000000000000000000000000000000082523060048301526020826024816001600160a01b037f000000000000000000000000beef047a543e45807105e51a8bbefcc5950fcfba165afa908115610494575f9161144b5761144892506112e5565b90506020813d602011611af5575b81611ae6602093836112a4565b8101031261022957515f611a54565b3d9150611ad9565b6040517f70a082310000000000000000000000000000000000000000000000000000000081523060048201526020816024816001600160a01b037f000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7165afa908115610494575f91611b8a575b50808211611b75575050565b81039081116112f257611b8790611734565b50565b90506020813d602011611bb4575b81611ba5602093836112a4565b8101031261022957515f611b69565b3d9150611b98565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b03929092166024830152604480830193909352918152611c1691611c116064836112a4565b611c18565b565b905f602091828151910182855af115610494575f513d611c7c57506001600160a01b0381163b155b611c475750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b60011415611c4056fea164736f6c634300081d000a