ETH Price: $2,409.77 (-2.85%)

Transaction Decoder

Block:
21218034 at Nov-18-2024 11:56:59 PM +UTC
Transaction Fee:
0.0009144573230448 ETH $2.20
Gas Used:
83,502 Gas / 10.9513224 Gwei

Emitted Events:

Account State Difference:

  Address   Before After State Difference Code
0x04AeBe2e...c4B48DD13
0x4591DBfF...3669fBB28
(beaverbuild)
10.883131441978077534 Eth10.883137642836597534 Eth0.00000620085852
0xab8c43e0...dbB35555A
0.029419270588229381 Eth
Nonce: 572
0.028504813265184581 Eth
Nonce: 573
0.0009144573230448

Execution Trace

Yearn.redeem( shares=140003615625967536350, receiver=0xab8c43e0c7358B92B32816C2250AA3cdbB35555A, owner=0xab8c43e0c7358B92B32816C2250AA3cdbB35555A, max_loss=1 ) => ( 140003615625967536350 )
  • Null: 0x000...004.STATICCALL( )
  • DebtToken.transfer( recipient=0xab8c43e0c7358B92B32816C2250AA3cdbB35555A, amount=140003615625967536350 ) => ( True )
    File 1 of 2: Yearn V3 Vault
    # @version 0.3.7
    
    """
    @title Yearn V3 Vault
    @license GNU AGPLv3
    @author yearn.finance
    @notice
        The Yearn VaultV3 is designed as an non-opinionated system to distribute funds of 
        depositors for a specific `asset` into different opportunities (aka Strategies)
        and manage accounting in a robust way.
    
        Depositors receive shares (aka vaults tokens) proportional to their deposit amount. 
        Vault tokens are yield-bearing and can be redeemed at any time to get back deposit 
        plus any yield generated.
    
        Addresses that are given different permissioned roles by the `role_manager` 
        are then able to allocate funds as they best see fit to different strategies 
        and adjust the strategies and allocations as needed, as well as reporting realized
        profits or losses.
    
        Strategies are any ERC-4626 compliant contracts that use the same underlying `asset` 
        as the vault. The vault provides no assurances as to the safety of any strategy
        and it is the responsibility of those that hold the corresponding roles to choose
        and fund strategies that best fit their desired specifications.
    
        Those holding vault tokens are able to redeem the tokens for the corresponding
        amount of underlying asset based on any reported profits or losses since their
        initial deposit.
    
        The vault is built to be customized by the management to be able to fit their
        specific desired needs Including the customization of strategies, accountants, 
        ownership etc.
    """
    
    from vyper.interfaces import ERC20
    from vyper.interfaces import ERC20Detailed
    
    # INTERFACES #
    interface IStrategy:
        def asset() -> address: view
        def balanceOf(owner: address) -> uint256: view
        def maxDeposit(receiver: address) -> uint256: view
        def redeem(shares: uint256, receiver: address, owner: address) -> uint256: nonpayable
        def deposit(assets: uint256, receiver: address) -> uint256: nonpayable
        def totalAssets() -> (uint256): view
        def convertToAssets(shares: uint256) -> uint256: view
        def convertToShares(assets: uint256) -> uint256: view
        def previewWithdraw(assets: uint256) -> uint256: view
        def maxRedeem(owner: address) -> uint256: view
    
    interface IAccountant:
        def report(strategy: address, gain: uint256, loss: uint256) -> (uint256, uint256): nonpayable
    
    interface IDepositLimitModule:
        def available_deposit_limit(receiver: address) -> uint256: view
        
    interface IWithdrawLimitModule:
        def available_withdraw_limit(owner: address, max_loss: uint256, strategies: DynArray[address, MAX_QUEUE]) -> uint256: view
    
    interface IFactory:
        def protocol_fee_config() -> (uint16, address): view
    
    # EVENTS #
    # ERC4626 EVENTS
    event Deposit:
        sender: indexed(address)
        owner: indexed(address)
        assets: uint256
        shares: uint256
    
    event Withdraw:
        sender: indexed(address)
        receiver: indexed(address)
        owner: indexed(address)
        assets: uint256
        shares: uint256
    
    # ERC20 EVENTS
    event Transfer:
        sender: indexed(address)
        receiver: indexed(address)
        value: uint256
    
    event Approval:
        owner: indexed(address)
        spender: indexed(address)
        value: uint256
    
    # STRATEGY EVENTS
    event StrategyChanged:
        strategy: indexed(address)
        change_type: indexed(StrategyChangeType)
        
    event StrategyReported:
        strategy: indexed(address)
        gain: uint256
        loss: uint256
        current_debt: uint256
        protocol_fees: uint256
        total_fees: uint256
        total_refunds: uint256
    
    # DEBT MANAGEMENT EVENTS
    event DebtUpdated:
        strategy: indexed(address)
        current_debt: uint256
        new_debt: uint256
    
    # ROLE UPDATES
    event RoleSet:
        account: indexed(address)
        role: indexed(Roles)
    
    event RoleStatusChanged:
        role: indexed(Roles)
        status: indexed(RoleStatusChange)
    
    # STORAGE MANAGEMENT EVENTS
    event UpdateRoleManager:
        role_manager: indexed(address)
    
    event UpdateAccountant:
        accountant: indexed(address)
    
    event UpdateDepositLimitModule:
        deposit_limit_module: indexed(address)
    
    event UpdateWithdrawLimitModule:
        withdraw_limit_module: indexed(address)
    
    event UpdateDefaultQueue:
        new_default_queue: DynArray[address, MAX_QUEUE]
    
    event UpdateUseDefaultQueue:
        use_default_queue: bool
    
    event UpdatedMaxDebtForStrategy:
        sender: indexed(address)
        strategy: indexed(address)
        new_debt: uint256
    
    event UpdateDepositLimit:
        deposit_limit: uint256
    
    event UpdateMinimumTotalIdle:
        minimum_total_idle: uint256
    
    event UpdateProfitMaxUnlockTime:
        profit_max_unlock_time: uint256
    
    event DebtPurchased:
        strategy: indexed(address)
        amount: uint256
    
    event Shutdown:
        pass
    
    # STRUCTS #
    struct StrategyParams:
        # Timestamp when the strategy was added.
        activation: uint256 
        # Timestamp of the strategies last report.
        last_report: uint256
        # The current assets the strategy holds.
        current_debt: uint256
        # The max assets the strategy can hold. 
        max_debt: uint256
    
    # CONSTANTS #
    # The max length the withdrawal queue can be.
    MAX_QUEUE: constant(uint256) = 10
    # 100% in Basis Points.
    MAX_BPS: constant(uint256) = 10_000
    # Extended for profit locking calculations.
    MAX_BPS_EXTENDED: constant(uint256) = 1_000_000_000_000
    # The version of this vault.
    API_VERSION: constant(String[28]) = "3.0.1"
    
    # ENUMS #
    # Each permissioned function has its own Role.
    # Roles can be combined in any combination or all kept separate.
    # Follows python Enum patterns so the first Enum == 1 and doubles each time.
    enum Roles:
        ADD_STRATEGY_MANAGER # Can add strategies to the vault.
        REVOKE_STRATEGY_MANAGER # Can remove strategies from the vault.
        FORCE_REVOKE_MANAGER # Can force remove a strategy causing a loss.
        ACCOUNTANT_MANAGER # Can set the accountant that assess fees.
        QUEUE_MANAGER # Can set the default withdrawal queue.
        REPORTING_MANAGER # Calls report for strategies.
        DEBT_MANAGER # Adds and removes debt from strategies.
        MAX_DEBT_MANAGER # Can set the max debt for a strategy.
        DEPOSIT_LIMIT_MANAGER # Sets deposit limit and module for the vault.
        WITHDRAW_LIMIT_MANAGER # Sets the withdraw limit module.
        MINIMUM_IDLE_MANAGER # Sets the minimum total idle the vault should keep.
        PROFIT_UNLOCK_MANAGER # Sets the profit_max_unlock_time.
        DEBT_PURCHASER # Can purchase bad debt from the vault.
        EMERGENCY_MANAGER # Can shutdown vault in an emergency.
    
    enum StrategyChangeType:
        ADDED
        REVOKED
    
    enum Rounding:
        ROUND_DOWN
        ROUND_UP
    
    enum RoleStatusChange:
        OPENED
        CLOSED
    
    # IMMUTABLE #
    # Underlying token used by the vault.
    ASSET: immutable(ERC20)
    # Based off the `asset` decimals.
    DECIMALS: immutable(uint256)
    # Deployer contract used to retrieve the protocol fee config.
    FACTORY: public(immutable(address))
    
    # STORAGE #
    # HashMap that records all the strategies that are allowed to receive assets from the vault.
    strategies: public(HashMap[address, StrategyParams])
    # The current default withdrawal queue.
    default_queue: public(DynArray[address, MAX_QUEUE])
    # Should the vault use the default_queue regardless whats passed in.
    use_default_queue: public(bool)
    
    # ERC20 - amount of shares per account
    balance_of: HashMap[address, uint256]
    # ERC20 - owner -> (spender -> amount)
    allowance: public(HashMap[address, HashMap[address, uint256]])
    # Total amount of shares that are currently minted including those locked.
    # NOTE: To get the ERC20 compliant version user totalSupply().
    total_supply: public(uint256)
    
    # Total amount of assets that has been deposited in strategies.
    total_debt: uint256
    # Current assets held in the vault contract. Replacing balanceOf(this) to avoid price_per_share manipulation.
    total_idle: uint256
    # Minimum amount of assets that should be kept in the vault contract to allow for fast, cheap redeems.
    minimum_total_idle: public(uint256)
    # Maximum amount of tokens that the vault can accept. If totalAssets > deposit_limit, deposits will revert.
    deposit_limit: public(uint256)
    # Contract that charges fees and can give refunds.
    accountant: public(address)
    # Contract to control the deposit limit.
    deposit_limit_module: public(address)
    # Contract to control the withdraw limit.
    withdraw_limit_module: public(address)
    # HashMap mapping addresses to their roles
    roles: public(HashMap[address, Roles])
    # HashMap mapping roles to their permissioned state. If false, the role is not open to the public.
    open_roles: public(HashMap[Roles, bool])
    # Address that can add and remove roles to addresses.
    role_manager: public(address)
    # Temporary variable to store the address of the next role_manager until the role is accepted.
    future_role_manager: public(address)
    
    # ERC20 - name of the vaults token.
    name: public(String[64])
    # ERC20 - symbol of the vaults token.
    symbol: public(String[32])
    
    # State of the vault - if set to true, only withdrawals will be available. It can't be reverted.
    shutdown: bool
    # The amount of time profits will unlock over.
    profit_max_unlock_time: uint256
    # The timestamp of when the current unlocking period ends.
    full_profit_unlock_date: uint256
    # The per second rate at which profit will unlock.
    profit_unlocking_rate: uint256
    # Last timestamp of the most recent profitable report.
    last_profit_update: uint256
    
    # `nonces` track `permit` approvals with signature.
    nonces: public(HashMap[address, uint256])
    DOMAIN_TYPE_HASH: constant(bytes32) = keccak256('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)')
    PERMIT_TYPE_HASH: constant(bytes32) = keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)")
    
    # Constructor
    @external
    def __init__(
        asset: ERC20, 
        name: String[64], 
        symbol: String[32], 
        role_manager: address, 
        profit_max_unlock_time: uint256
    ):
        """
        @notice
            The constructor for the vault. Sets the asset, name, symbol, and role manager.
        @param asset
            The address of the asset that the vault will accept.
        @param name
            The name of the vault token.
        @param symbol
            The symbol of the vault token.
        @param role_manager 
            The address that can add and remove roles to addresses
        @param profit_max_unlock_time
            The amount of time that the profit will be locked for
        """
        ASSET = asset
        DECIMALS = convert(ERC20Detailed(asset.address).decimals(), uint256)
        assert DECIMALS < 256 # dev: see VVE-2020-0001
        
        FACTORY = msg.sender
    
        # Must be less than one year for report cycles
        assert profit_max_unlock_time <= 31_556_952 # dev: profit unlock time too long
        self.profit_max_unlock_time = profit_max_unlock_time
    
        self.name = name
        self.symbol = symbol
        self.role_manager = role_manager
    
    ## SHARE MANAGEMENT ##
    ## ERC20 ##
    @internal
    def _spend_allowance(owner: address, spender: address, amount: uint256):
        # Unlimited approval does nothing (saves an SSTORE)
        current_allowance: uint256 = self.allowance[owner][spender]
        if (current_allowance < max_value(uint256)):
            assert current_allowance >= amount, "insufficient allowance"
            self._approve(owner, spender, unsafe_sub(current_allowance, amount))
    
    @internal
    def _transfer(sender: address, receiver: address, amount: uint256):
        sender_balance: uint256 = self.balance_of[sender]
        assert sender_balance >= amount, "insufficient funds"
        self.balance_of[sender] = unsafe_sub(sender_balance, amount)
        self.balance_of[receiver] = unsafe_add(self.balance_of[receiver], amount)
        log Transfer(sender, receiver, amount)
    
    @internal
    def _transfer_from(sender: address, receiver: address, amount: uint256) -> bool:
        self._spend_allowance(sender, msg.sender, amount)
        self._transfer(sender, receiver, amount)
        return True
    
    @internal
    def _approve(owner: address, spender: address, amount: uint256) -> bool:
        self.allowance[owner][spender] = amount
        log Approval(owner, spender, amount)
        return True
    
    @internal
    def _increase_allowance(owner: address, spender: address, amount: uint256) -> bool:
        new_allowance: uint256 = self.allowance[owner][spender] + amount
        self.allowance[owner][spender] = new_allowance
        log Approval(owner, spender, new_allowance)
        return True
    
    @internal
    def _decrease_allowance(owner: address, spender: address, amount: uint256) -> bool:
        new_allowance: uint256 = self.allowance[owner][spender] - amount
        self.allowance[owner][spender] = new_allowance
        log Approval(owner, spender, new_allowance)
        return True
    
    @internal
    def _permit(
        owner: address, 
        spender: address, 
        amount: uint256, 
        deadline: uint256, 
        v: uint8, 
        r: bytes32, 
        s: bytes32
    ) -> bool:
        assert owner != empty(address), "invalid owner"
        assert deadline >= block.timestamp, "permit expired"
        nonce: uint256 = self.nonces[owner]
        digest: bytes32 = keccak256(
            concat(
                b'\x19\x01',
                self.domain_separator(),
                keccak256(
                    concat(
                        PERMIT_TYPE_HASH,
                        convert(owner, bytes32),
                        convert(spender, bytes32),
                        convert(amount, bytes32),
                        convert(nonce, bytes32),
                        convert(deadline, bytes32),
                    )
                )
            )
        )
        assert ecrecover(
            digest, convert(v, uint256), convert(r, uint256), convert(s, uint256)
        ) == owner, "invalid signature"
    
        self.allowance[owner][spender] = amount
        self.nonces[owner] = nonce + 1
        log Approval(owner, spender, amount)
        return True
    
    @internal
    def _burn_shares(shares: uint256, owner: address):
        self.balance_of[owner] -= shares
        self.total_supply = unsafe_sub(self.total_supply, shares)
        log Transfer(owner, empty(address), shares)
    
    @view
    @internal
    def _unlocked_shares() -> uint256:
        """
        Returns the amount of shares that have been unlocked.
        To avoid sudden price_per_share spikes, profits must be processed 
        through an unlocking period. The mechanism involves shares to be 
        minted to the vault which are unlocked gradually over time. Shares 
        that have been locked are gradually unlocked over profit_max_unlock_time.
        """
        _full_profit_unlock_date: uint256 = self.full_profit_unlock_date
        unlocked_shares: uint256 = 0
        if _full_profit_unlock_date > block.timestamp:
            # If we have not fully unlocked, we need to calculate how much has been.
            unlocked_shares = self.profit_unlocking_rate * (block.timestamp - self.last_profit_update) / MAX_BPS_EXTENDED
    
        elif _full_profit_unlock_date != 0:
            # All shares have been unlocked
            unlocked_shares = self.balance_of[self]
    
        return unlocked_shares
    
    
    @view
    @internal
    def _total_supply() -> uint256:
        # Need to account for the shares issued to the vault that have unlocked.
        return self.total_supply - self._unlocked_shares()
    
    @internal
    def _burn_unlocked_shares():
        """
        Burns shares that have been unlocked since last update. 
        In case the full unlocking period has passed, it stops the unlocking.
        """
        # Get the amount of shares that have unlocked
        unlocked_shares: uint256 = self._unlocked_shares()
    
        # IF 0 there's nothing to do.
        if unlocked_shares == 0:
            return
    
        # Only do an SSTORE if necessary
        if self.full_profit_unlock_date > block.timestamp:
            self.last_profit_update = block.timestamp
    
        # Burn the shares unlocked.
        self._burn_shares(unlocked_shares, self)
    
    @view
    @internal
    def _total_assets() -> uint256:
        """
        Total amount of assets that are in the vault and in the strategies. 
        """
        return self.total_idle + self.total_debt
    
    @view
    @internal
    def _convert_to_assets(shares: uint256, rounding: Rounding) -> uint256:
        """ 
        assets = shares * (total_assets / total_supply) --- (== price_per_share * shares)
        """
        if shares == max_value(uint256) or shares == 0:
            return shares
    
        total_supply: uint256 = self._total_supply()
        # if total_supply is 0, price_per_share is 1
        if total_supply == 0: 
            return shares
    
        numerator: uint256 = shares * self._total_assets()
        amount: uint256 = numerator / total_supply
        if rounding == Rounding.ROUND_UP and numerator % total_supply != 0:
            amount += 1
    
        return amount
    
    @view
    @internal
    def _convert_to_shares(assets: uint256, rounding: Rounding) -> uint256:
        """
        shares = amount * (total_supply / total_assets) --- (== amount / price_per_share)
        """
        if assets == max_value(uint256) or assets == 0:
            return assets
    
        total_supply: uint256 = self._total_supply()
        total_assets: uint256 = self._total_assets()
    
        if total_assets == 0:
            # if total_assets and total_supply is 0, price_per_share is 1
            if total_supply == 0:
                return assets
            else:
                # Else if total_supply > 0 price_per_share is 0
                return 0
    
        numerator: uint256 = assets * total_supply
        shares: uint256 = numerator / total_assets
        if rounding == Rounding.ROUND_UP and numerator % total_assets != 0:
            shares += 1
    
        return shares
    
    @internal
    def _erc20_safe_approve(token: address, spender: address, amount: uint256):
        # Used only to approve tokens that are not the type managed by this Vault.
        # Used to handle non-compliant tokens like USDT
        assert ERC20(token).approve(spender, amount, default_return_value=True), "approval failed"
    
    @internal
    def _erc20_safe_transfer_from(token: address, sender: address, receiver: address, amount: uint256):
        # Used only to transfer tokens that are not the type managed by this Vault.
        # Used to handle non-compliant tokens like USDT
        assert ERC20(token).transferFrom(sender, receiver, amount, default_return_value=True), "transfer failed"
    
    @internal
    def _erc20_safe_transfer(token: address, receiver: address, amount: uint256):
        # Used only to send tokens that are not the type managed by this Vault.
        # Used to handle non-compliant tokens like USDT
        assert ERC20(token).transfer(receiver, amount, default_return_value=True), "transfer failed"
    
    @internal
    def _issue_shares(shares: uint256, recipient: address):
        self.balance_of[recipient] = unsafe_add(self.balance_of[recipient], shares)
        self.total_supply += shares
    
        log Transfer(empty(address), recipient, shares)
    
    @internal
    def _issue_shares_for_amount(amount: uint256, recipient: address) -> uint256:
        """
        Issues shares that are worth 'amount' in the underlying token (asset).
        WARNING: this takes into account that any new assets have been summed 
        to total_assets (otherwise pps will go down).
        """
        total_supply: uint256 = self._total_supply()
        total_assets: uint256 = self._total_assets()
        new_shares: uint256 = 0
        
        # If no supply PPS = 1.
        if total_supply == 0:
            new_shares = amount
        elif total_assets > amount:
            new_shares = amount * total_supply / (total_assets - amount)
        else:
            # If total_supply > 0 but amount = totalAssets we want to revert because
            # after first deposit, getting here would mean that the rest of the shares
            # would be diluted to a price_per_share of 0. Issuing shares would then mean
            # either the new depositor or the previous depositors will loose money.
            assert total_assets > amount, "amount too high"
      
        # We don't make the function revert
        if new_shares == 0:
           return 0
    
        self._issue_shares(new_shares, recipient)
    
        return new_shares
    
    ## ERC4626 ##
    @view
    @internal
    def _max_deposit(receiver: address) -> uint256: 
        if receiver in [empty(address), self]:
            return 0
    
        # If there is a deposit limit module set use that.
        deposit_limit_module: address = self.deposit_limit_module
        if deposit_limit_module != empty(address):
            return IDepositLimitModule(deposit_limit_module).available_deposit_limit(receiver)
        
        # Else use the standard flow.
        _total_assets: uint256 = self._total_assets()
        _deposit_limit: uint256 = self.deposit_limit
        if (_total_assets >= _deposit_limit):
            return 0
    
        return unsafe_sub(_deposit_limit, _total_assets)
    
    @view
    @internal
    def _max_withdraw(
        owner: address,
        max_loss: uint256,
        strategies: DynArray[address, MAX_QUEUE]
    ) -> uint256:
        """
        @dev Returns the max amount of `asset` an `owner` can withdraw.
    
        This will do a full simulation of the withdraw in order to determine
        how much is currently liquid and if the `max_loss` would allow for the 
        tx to not revert.
    
        This will track any expected loss to check if the tx will revert, but
        not account for it in the amount returned since it is unrealised and 
        therefore will not be accounted for in the conversion rates.
    
        i.e. If we have 100 debt and 10 of unrealised loss, the max we can get
        out is 90, but a user of the vault will need to call withdraw with 100
        in order to get the full 90 out.
        """
    
        # Get the max amount for the owner if fully liquid.
        max_assets: uint256 = self._convert_to_assets(self.balance_of[owner], Rounding.ROUND_DOWN)
    
        # If there is a withdraw limit module use that.
        withdraw_limit_module: address = self.withdraw_limit_module
        if withdraw_limit_module != empty(address):
            return min(
                # Use the min between the returned value and the max.
                # Means the limit module doesn't need to account for balances or conversions.
                IWithdrawLimitModule(withdraw_limit_module).available_withdraw_limit(owner, max_loss, strategies),
                max_assets
            )
        
        # See if we have enough idle to service the withdraw.
        current_idle: uint256 = self.total_idle
        if max_assets > current_idle:
            # Track how much we can pull.
            have: uint256 = current_idle
            loss: uint256 = 0
    
            # Cache the default queue.
            _strategies: DynArray[address, MAX_QUEUE] = self.default_queue
    
            # If a custom queue was passed, and we don't force the default queue.
            if len(strategies) != 0 and not self.use_default_queue:
                # Use the custom queue.
                _strategies = strategies
    
            for strategy in _strategies:
                # Can't use an invalid strategy.
                assert self.strategies[strategy].activation != 0, "inactive strategy"
    
                # Get the maximum amount the vault would withdraw from the strategy.
                to_withdraw: uint256 = min(
                    # What we still need for the full withdraw.
                    max_assets - have, 
                    # The current debt the strategy has.
                    self.strategies[strategy].current_debt
                )
    
                # Get any unrealised loss for the strategy.
                unrealised_loss: uint256 = self._assess_share_of_unrealised_losses(strategy, to_withdraw)
    
                # See if any limit is enforced by the strategy.
                strategy_limit: uint256 = IStrategy(strategy).convertToAssets(
                    IStrategy(strategy).maxRedeem(self)
                )
    
                # Adjust accordingly if there is a max withdraw limit.
                if strategy_limit < to_withdraw - unrealised_loss:
                    # lower unrealised loss to the proportional to the limit.
                    unrealised_loss = unrealised_loss * strategy_limit / to_withdraw
                    # Still count the unrealised loss as withdrawable.
                    to_withdraw = strategy_limit + unrealised_loss
    
                # If 0 move on to the next strategy.
                if to_withdraw == 0:
                    continue
    
                # If there would be a loss with a non-maximum `max_loss` value.
                if unrealised_loss > 0 and max_loss < MAX_BPS:
                    # Check if the loss is greater than the allowed range.
                    if loss + unrealised_loss > (have + to_withdraw) * max_loss / MAX_BPS:
                        # If so use the amounts up till now.
                        break
    
                # Add to what we can pull.
                have += to_withdraw
    
                # If we have all we need break.
                if have >= max_assets:
                    break
    
                # Add any unrealised loss to the total
                loss += unrealised_loss
    
            # Update the max after going through the queue.
            # In case we broke early or exhausted the queue.
            max_assets = have
    
        return max_assets
    
    @internal
    def _deposit(sender: address, recipient: address, assets: uint256) -> uint256:
        """
        Used for `deposit` calls to transfer the amount of `asset` to the vault, 
        issue the corresponding shares to the `recipient` and update all needed 
        vault accounting.
        """
        assert self.shutdown == False # dev: shutdown
        assert assets <= self._max_deposit(recipient), "exceed deposit limit"
     
        # Transfer the tokens to the vault first.
        self._erc20_safe_transfer_from(ASSET.address, msg.sender, self, assets)
        # Record the change in total assets.
        self.total_idle += assets
        
        # Issue the corresponding shares for assets.
        shares: uint256 = self._issue_shares_for_amount(assets, recipient)
    
        assert shares > 0, "cannot mint zero"
    
        log Deposit(sender, recipient, assets, shares)
        return shares
    
    @internal
    def _mint(sender: address, recipient: address, shares: uint256) -> uint256:
        """
        Used for `mint` calls to issue the corresponding shares to the `recipient`,
        transfer the amount of `asset` to the vault, and update all needed vault 
        accounting.
        """
        assert self.shutdown == False # dev: shutdown
        # Get corresponding amount of assets.
        assets: uint256 = self._convert_to_assets(shares, Rounding.ROUND_UP)
    
        assert assets > 0, "cannot deposit zero"
        assert assets <= self._max_deposit(recipient), "exceed deposit limit"
    
        # Transfer the tokens to the vault first.
        self._erc20_safe_transfer_from(ASSET.address, msg.sender, self, assets)
        # Record the change in total assets.
        self.total_idle += assets
        
        # Issue the corresponding shares for assets.
        self._issue_shares(shares, recipient)
    
        log Deposit(sender, recipient, assets, shares)
        return assets
    
    @view
    @internal
    def _assess_share_of_unrealised_losses(strategy: address, assets_needed: uint256) -> uint256:
        """
        Returns the share of losses that a user would take if withdrawing from this strategy
        e.g. if the strategy has unrealised losses for 10% of its current debt and the user 
        wants to withdraw 1000 tokens, the losses that he will take are 100 token
        """
        # Minimum of how much debt the debt should be worth.
        strategy_current_debt: uint256 = self.strategies[strategy].current_debt
        # The actual amount that the debt is currently worth.
        vault_shares: uint256 = IStrategy(strategy).balanceOf(self)
        strategy_assets: uint256 = IStrategy(strategy).convertToAssets(vault_shares)
        
        # If no losses, return 0
        if strategy_assets >= strategy_current_debt or strategy_current_debt == 0:
            return 0
    
        # Users will withdraw assets_to_withdraw divided by loss ratio (strategy_assets / strategy_current_debt - 1),
        # but will only receive assets_to_withdraw.
        # NOTE: If there are unrealised losses, the user will take his share.
        numerator: uint256 = assets_needed * strategy_assets
        losses_user_share: uint256 = assets_needed - numerator / strategy_current_debt
        # Always round up.
        if numerator % strategy_current_debt != 0:
            losses_user_share += 1
    
        return losses_user_share
    
    @internal
    def _withdraw_from_strategy(strategy: address, assets_to_withdraw: uint256):
        """
        This takes the amount denominated in asset and performs a {redeem}
        with the corresponding amount of shares.
    
        We use {redeem} to natively take on losses without additional non-4626 standard parameters.
        """
        # Need to get shares since we use redeem to be able to take on losses.
        shares_to_redeem: uint256 = min(
            # Use previewWithdraw since it should round up.
            IStrategy(strategy).previewWithdraw(assets_to_withdraw), 
            # And check against our actual balance.
            IStrategy(strategy).balanceOf(self)
        )
        # Redeem the shares.
        IStrategy(strategy).redeem(shares_to_redeem, self, self)
    
    @internal
    def _redeem(
        sender: address, 
        receiver: address, 
        owner: address,
        assets: uint256,
        shares_to_burn: uint256, 
        max_loss: uint256,
        strategies: DynArray[address, MAX_QUEUE]
    ) -> uint256:
        """
        This will attempt to free up the full amount of assets equivalent to
        `shares_to_burn` and transfer them to the `receiver`. If the vault does
        not have enough idle funds it will go through any strategies provided by
        either the withdrawer or the queue_manager to free up enough funds to 
        service the request.
    
        The vault will attempt to account for any unrealized losses taken on from
        strategies since their respective last reports.
    
        Any losses realized during the withdraw from a strategy will be passed on
        to the user that is redeeming their vault shares.
        """
        assert receiver != empty(address), "ZERO ADDRESS"
        assert max_loss <= MAX_BPS, "max loss"
    
        # If there is a withdraw limit module, check the max.
        if self.withdraw_limit_module != empty(address):
            assert assets <= self._max_withdraw(owner, max_loss, strategies), "exceed withdraw limit"
    
        shares: uint256 = shares_to_burn
        shares_balance: uint256 = self.balance_of[owner]
    
        assert shares > 0, "no shares to redeem"
        assert shares_balance >= shares, "insufficient shares to redeem"
        
        if sender != owner:
            self._spend_allowance(owner, sender, shares_to_burn)
    
        # The amount of the underlying token to withdraw.
        requested_assets: uint256 = assets
    
        # load to memory to save gas
        curr_total_idle: uint256 = self.total_idle
        
        # If there are not enough assets in the Vault contract, we try to free
        # funds from strategies.
        if requested_assets > curr_total_idle:
    
            # Cache the default queue.
            _strategies: DynArray[address, MAX_QUEUE] = self.default_queue
    
            # If a custom queue was passed, and we don't force the default queue.
            if len(strategies) != 0 and not self.use_default_queue:
                # Use the custom queue.
                _strategies = strategies
    
            # load to memory to save gas
            curr_total_debt: uint256 = self.total_debt
    
            # Withdraw from strategies only what idle doesn't cover.
            # `assets_needed` is the total amount we need to fill the request.
            assets_needed: uint256 = unsafe_sub(requested_assets, curr_total_idle)
            # `assets_to_withdraw` is the amount to request from the current strategy.
            assets_to_withdraw: uint256 = 0
    
            # To compare against real withdrawals from strategies
            previous_balance: uint256 = ASSET.balanceOf(self)
    
            for strategy in _strategies:
                # Make sure we have a valid strategy.
                assert self.strategies[strategy].activation != 0, "inactive strategy"
    
                # How much should the strategy have.
                current_debt: uint256 = self.strategies[strategy].current_debt
    
                # What is the max amount to withdraw from this strategy.
                assets_to_withdraw = min(assets_needed, current_debt)
    
                # Cache max_withdraw now for use if unrealized loss > 0
                # Use maxRedeem and convert since we use redeem.
                max_withdraw: uint256 = IStrategy(strategy).convertToAssets(
                    IStrategy(strategy).maxRedeem(self)
                )
    
                # CHECK FOR UNREALISED LOSSES
                # If unrealised losses > 0, then the user will take the proportional share 
                # and realize it (required to avoid users withdrawing from lossy strategies).
                # NOTE: strategies need to manage the fact that realising part of the loss can 
                # mean the realisation of 100% of the loss!! (i.e. if for withdrawing 10% of the
                # strategy it needs to unwind the whole position, generated losses might be bigger)
                unrealised_losses_share: uint256 = self._assess_share_of_unrealised_losses(strategy, assets_to_withdraw)
                if unrealised_losses_share > 0:
                    # If max withdraw is limiting the amount to pull, we need to adjust the portion of 
                    # the unrealized loss the user should take.
                    if max_withdraw < assets_to_withdraw - unrealised_losses_share:
                        # How much would we want to withdraw
                        wanted: uint256 = assets_to_withdraw - unrealised_losses_share
                        # Get the proportion of unrealised comparing what we want vs. what we can get
                        unrealised_losses_share = unrealised_losses_share * max_withdraw / wanted
                        # Adjust assets_to_withdraw so all future calculations work correctly
                        assets_to_withdraw = max_withdraw + unrealised_losses_share
                    
                    # User now "needs" less assets to be unlocked (as he took some as losses)
                    assets_to_withdraw -= unrealised_losses_share
                    requested_assets -= unrealised_losses_share
                    # NOTE: done here instead of waiting for regular update of these values 
                    # because it's a rare case (so we can save minor amounts of gas)
                    assets_needed -= unrealised_losses_share
                    curr_total_debt -= unrealised_losses_share
    
                    # If max withdraw is 0 and unrealised loss is still > 0 then the strategy likely
                    # realized a 100% loss and we will need to realize that loss before moving on.
                    if max_withdraw == 0 and unrealised_losses_share > 0:
                        # Adjust the strategy debt accordingly.
                        new_debt: uint256 = current_debt - unrealised_losses_share
            
                        # Update strategies storage
                        self.strategies[strategy].current_debt = new_debt
                        # Log the debt update
                        log DebtUpdated(strategy, current_debt, new_debt)
    
                # Adjust based on the max withdraw of the strategy.
                assets_to_withdraw = min(assets_to_withdraw, max_withdraw)
    
                # Can't withdraw 0.
                if assets_to_withdraw == 0:
                    continue
                
                # WITHDRAW FROM STRATEGY
                self._withdraw_from_strategy(strategy, assets_to_withdraw)
                post_balance: uint256 = ASSET.balanceOf(self)
                
                # Always check withdrawn against the real amounts.
                withdrawn: uint256 = post_balance - previous_balance
                loss: uint256 = 0
                # Check if we redeemed too much.
                if withdrawn > assets_to_withdraw:
                    # Make sure we don't underflow in debt updates.
                    if withdrawn > current_debt:
                        # Can't withdraw more than our debt.
                        assets_to_withdraw = current_debt
                    else:
                        # Add the extra to how much we withdrew.
                        assets_to_withdraw += (unsafe_sub(withdrawn, assets_to_withdraw))
    
                # If we have not received what we expected, we consider the difference a loss.
                elif withdrawn < assets_to_withdraw:
                    loss = unsafe_sub(assets_to_withdraw, withdrawn)
    
                # NOTE: strategy's debt decreases by the full amount but the total idle increases 
                # by the actual amount only (as the difference is considered lost).
                curr_total_idle += (assets_to_withdraw - loss)
                requested_assets -= loss
                curr_total_debt -= assets_to_withdraw
    
                # Vault will reduce debt because the unrealised loss has been taken by user
                new_debt: uint256 = current_debt - (assets_to_withdraw + unrealised_losses_share)
            
                # Update strategies storage
                self.strategies[strategy].current_debt = new_debt
                # Log the debt update
                log DebtUpdated(strategy, current_debt, new_debt)
    
                # Break if we have enough total idle to serve initial request.
                if requested_assets <= curr_total_idle:
                    break
    
                # We update the previous_balance variable here to save gas in next iteration.
                previous_balance = post_balance
    
                # Reduce what we still need. Safe to use assets_to_withdraw 
                # here since it has been checked against requested_assets
                assets_needed -= assets_to_withdraw
    
            # If we exhaust the queue and still have insufficient total idle, revert.
            assert curr_total_idle >= requested_assets, "insufficient assets in vault"
            # Commit memory to storage.
            self.total_debt = curr_total_debt
    
        # Check if there is a loss and a non-default value was set.
        if assets > requested_assets and max_loss < MAX_BPS:
            # Assure the loss is within the allowed range.
            assert assets - requested_assets <= assets * max_loss / MAX_BPS, "too much loss"
    
        # First burn the corresponding shares from the redeemer.
        self._burn_shares(shares, owner)
        # Commit memory to storage.
        self.total_idle = curr_total_idle - requested_assets
        # Transfer the requested amount to the receiver.
        self._erc20_safe_transfer(ASSET.address, receiver, requested_assets)
    
        log Withdraw(sender, receiver, owner, requested_assets, shares)
        return requested_assets
    
    ## STRATEGY MANAGEMENT ##
    @internal
    def _add_strategy(new_strategy: address):
        assert new_strategy not in [self, empty(address)], "strategy cannot be zero address"
        assert IStrategy(new_strategy).asset() == ASSET.address, "invalid asset"
        assert self.strategies[new_strategy].activation == 0, "strategy already active"
    
        # Add the new strategy to the mapping.
        self.strategies[new_strategy] = StrategyParams({
            activation: block.timestamp,
            last_report: block.timestamp,
            current_debt: 0,
            max_debt: 0
        })
    
        # If the default queue has space, add the strategy.
        if len(self.default_queue) < MAX_QUEUE:
            self.default_queue.append(new_strategy)        
            
        log StrategyChanged(new_strategy, StrategyChangeType.ADDED)
    
    @internal
    def _revoke_strategy(strategy: address, force: bool=False):
        assert self.strategies[strategy].activation != 0, "strategy not active"
    
        # If force revoking a strategy, it will cause a loss.
        loss: uint256 = 0
        
        if self.strategies[strategy].current_debt != 0:
            assert force, "strategy has debt"
            # Vault realizes the full loss of outstanding debt.
            loss = self.strategies[strategy].current_debt
            # Adjust total vault debt.
            self.total_debt -= loss
    
            log StrategyReported(strategy, 0, loss, 0, 0, 0, 0)
    
        # Set strategy params all back to 0 (WARNING: it can be re-added).
        self.strategies[strategy] = StrategyParams({
          activation: 0,
          last_report: 0,
          current_debt: 0,
          max_debt: 0
        })
    
        # Remove strategy if it is in the default queue.
        new_queue: DynArray[address, MAX_QUEUE] = []
        for _strategy in self.default_queue:
            # Add all strategies to the new queue besides the one revoked.
            if _strategy != strategy:
                new_queue.append(_strategy)
            
        # Set the default queue to our updated queue.
        self.default_queue = new_queue
    
        log StrategyChanged(strategy, StrategyChangeType.REVOKED)
    
    # DEBT MANAGEMENT #
    @internal
    def _update_debt(strategy: address, target_debt: uint256) -> uint256:
        """
        The vault will re-balance the debt vs target debt. Target debt must be
        smaller or equal to strategy's max_debt. This function will compare the 
        current debt with the target debt and will take funds or deposit new 
        funds to the strategy. 
    
        The strategy can require a maximum amount of funds that it wants to receive
        to invest. The strategy can also reject freeing funds if they are locked.
        """
        # How much we want the strategy to have.
        new_debt: uint256 = target_debt
        # How much the strategy currently has.
        current_debt: uint256 = self.strategies[strategy].current_debt
    
        # If the vault is shutdown we can only pull funds.
        if self.shutdown:
            new_debt = 0
    
        assert new_debt != current_debt, "new debt equals current debt"
    
        if current_debt > new_debt:
            # Reduce debt.
            assets_to_withdraw: uint256 = unsafe_sub(current_debt, new_debt)
    
            # Ensure we always have minimum_total_idle when updating debt.
            minimum_total_idle: uint256 = self.minimum_total_idle
            total_idle: uint256 = self.total_idle
            
            # Respect minimum total idle in vault
            if total_idle + assets_to_withdraw < minimum_total_idle:
                assets_to_withdraw = unsafe_sub(minimum_total_idle, total_idle)
                # Cant withdraw more than the strategy has.
                if assets_to_withdraw > current_debt:
                    assets_to_withdraw = current_debt
    
            # Check how much we are able to withdraw.
            # Use maxRedeem and convert since we use redeem.
            withdrawable: uint256 = IStrategy(strategy).convertToAssets(
                IStrategy(strategy).maxRedeem(self)
            )
            assert withdrawable != 0, "nothing to withdraw"
    
            # If insufficient withdrawable, withdraw what we can.
            if withdrawable < assets_to_withdraw:
                assets_to_withdraw = withdrawable
    
            # If there are unrealised losses we don't let the vault reduce its debt until there is a new report
            unrealised_losses_share: uint256 = self._assess_share_of_unrealised_losses(strategy, assets_to_withdraw)
            assert unrealised_losses_share == 0, "strategy has unrealised losses"
            
            # Always check the actual amount withdrawn.
            pre_balance: uint256 = ASSET.balanceOf(self)
            self._withdraw_from_strategy(strategy, assets_to_withdraw)
            post_balance: uint256 = ASSET.balanceOf(self)
            
            # making sure we are changing idle according to the real result no matter what. 
            # We pull funds with {redeem} so there can be losses or rounding differences.
            withdrawn: uint256 = min(post_balance - pre_balance, current_debt)
    
            # If we got too much make sure not to increase PPS.
            if withdrawn > assets_to_withdraw:
                assets_to_withdraw = withdrawn
    
            # Update storage.
            self.total_idle += withdrawn # actual amount we got.
            # Amount we tried to withdraw in case of losses
            self.total_debt -= assets_to_withdraw 
    
            new_debt = current_debt - assets_to_withdraw
        else: 
            # We are increasing the strategies debt
    
            # Revert if target_debt cannot be achieved due to configured max_debt for given strategy
            assert new_debt <= self.strategies[strategy].max_debt, "target debt higher than max debt"
    
            # Vault is increasing debt with the strategy by sending more funds.
            max_deposit: uint256 = IStrategy(strategy).maxDeposit(self)
            assert max_deposit != 0, "nothing to deposit"
    
            # Deposit the difference between desired and current.
            assets_to_deposit: uint256 = new_debt - current_debt
            if assets_to_deposit > max_deposit:
                # Deposit as much as possible.
                assets_to_deposit = max_deposit
            
            # Ensure we always have minimum_total_idle when updating debt.
            minimum_total_idle: uint256 = self.minimum_total_idle
            total_idle: uint256 = self.total_idle
    
            assert total_idle > minimum_total_idle, "no funds to deposit"
            available_idle: uint256 = unsafe_sub(total_idle, minimum_total_idle)
    
            # If insufficient funds to deposit, transfer only what is free.
            if assets_to_deposit > available_idle:
                assets_to_deposit = available_idle
    
            # Can't Deposit 0.
            if assets_to_deposit > 0:
                # Approve the strategy to pull only what we are giving it.
                self._erc20_safe_approve(ASSET.address, strategy, assets_to_deposit)
    
                # Always update based on actual amounts deposited.
                pre_balance: uint256 = ASSET.balanceOf(self)
                IStrategy(strategy).deposit(assets_to_deposit, self)
                post_balance: uint256 = ASSET.balanceOf(self)
    
                # Make sure our approval is always back to 0.
                self._erc20_safe_approve(ASSET.address, strategy, 0)
    
                # Making sure we are changing according to the real result no 
                # matter what. This will spend more gas but makes it more robust.
                assets_to_deposit = pre_balance - post_balance
    
                # Update storage.
                self.total_idle -= assets_to_deposit
                self.total_debt += assets_to_deposit
    
            new_debt = current_debt + assets_to_deposit
    
        # Commit memory to storage.
        self.strategies[strategy].current_debt = new_debt
    
        log DebtUpdated(strategy, current_debt, new_debt)
        return new_debt
    
    ## ACCOUNTING MANAGEMENT ##
    @internal
    def _process_report(strategy: address) -> (uint256, uint256):
        """
        Processing a report means comparing the debt that the strategy has taken 
        with the current amount of funds it is reporting. If the strategy owes 
        less than it currently has, it means it has had a profit, else (assets < debt) 
        it has had a loss.
    
        Different strategies might choose different reporting strategies: pessimistic, 
        only realised P&L, ... The best way to report depends on the strategy.
    
        The profit will be distributed following a smooth curve over the vaults 
        profit_max_unlock_time seconds. Losses will be taken immediately, first from the 
        profit buffer (avoiding an impact in pps), then will reduce pps.
    
        Any applicable fees are charged and distributed during the report as well
        to the specified recipients.
        """
        # Make sure we have a valid strategy.
        assert self.strategies[strategy].activation != 0, "inactive strategy"
    
        # Burn shares that have been unlocked since the last update
        self._burn_unlocked_shares()
    
        # Vault assesses profits using 4626 compliant interface. 
        # NOTE: It is important that a strategies `convertToAssets` implementation
        # cannot be manipulated or else the vault could report incorrect gains/losses.
        strategy_shares: uint256 = IStrategy(strategy).balanceOf(self)
        # How much the vaults position is worth.
        total_assets: uint256 = IStrategy(strategy).convertToAssets(strategy_shares)
        # How much the vault had deposited to the strategy.
        current_debt: uint256 = self.strategies[strategy].current_debt
    
        gain: uint256 = 0
        loss: uint256 = 0
    
        # Compare reported assets vs. the current debt.
        if total_assets > current_debt:
            # We have a gain.
            gain = unsafe_sub(total_assets, current_debt)
        else:
            # We have a loss.
            loss = unsafe_sub(current_debt, total_assets)
    
        # For Accountant fee assessment.
        total_fees: uint256 = 0
        total_refunds: uint256 = 0
        # For Protocol fee assessment.
        protocol_fees: uint256 = 0
        protocol_fee_recipient: address = empty(address)
    
        accountant: address = self.accountant
        # If accountant is not set, fees and refunds remain unchanged.
        if accountant != empty(address):
            total_fees, total_refunds = IAccountant(accountant).report(strategy, gain, loss)
    
            # Protocol fees will be 0 if accountant fees are 0.
            if total_fees > 0:
                protocol_fee_bps: uint16 = 0
                # Get the config for this vault.
                protocol_fee_bps, protocol_fee_recipient = IFactory(FACTORY).protocol_fee_config()
    
                if(protocol_fee_bps > 0):
                    # Protocol fees are a percent of the fees the accountant is charging.
                    protocol_fees = total_fees * convert(protocol_fee_bps, uint256) / MAX_BPS
    
        # `shares_to_burn` is derived from amounts that would reduce the vaults PPS.
        # NOTE: this needs to be done before any pps changes
        shares_to_burn: uint256 = 0
        accountant_fees_shares: uint256 = 0
        protocol_fees_shares: uint256 = 0
        # Only need to burn shares if there is a loss or fees.
        if loss + total_fees > 0:
            # The amount of shares we will want to burn to offset losses and fees.
            shares_to_burn += self._convert_to_shares(loss + total_fees, Rounding.ROUND_UP)
    
            # Vault calculates the amount of shares to mint as fees before changing totalAssets / totalSupply.
            if total_fees > 0:
                # Accountant fees are total fees - protocol fees.
                accountant_fees_shares = self._convert_to_shares(total_fees - protocol_fees, Rounding.ROUND_DOWN)
                if protocol_fees > 0:
                  protocol_fees_shares = self._convert_to_shares(protocol_fees, Rounding.ROUND_DOWN)
    
        # Shares to lock is any amounts that would otherwise increase the vaults PPS.
        newly_locked_shares: uint256 = 0
        if total_refunds > 0:
            # Make sure we have enough approval and enough asset to pull.
            total_refunds = min(total_refunds, min(ASSET.balanceOf(accountant), ASSET.allowance(accountant, self)))
            # Transfer the refunded amount of asset to the vault.
            self._erc20_safe_transfer_from(ASSET.address, accountant, self, total_refunds)
            # Update storage to increase total assets.
            self.total_idle += total_refunds
    
        # Record any reported gains.
        if gain > 0:
            # NOTE: this will increase total_assets
            self.strategies[strategy].current_debt += gain
            self.total_debt += gain
    
        profit_max_unlock_time: uint256 = self.profit_max_unlock_time
        # Mint anything we are locking to the vault.
        if gain + total_refunds > 0 and profit_max_unlock_time != 0:
            newly_locked_shares = self._issue_shares_for_amount(gain + total_refunds, self)
    
        # Strategy is reporting a loss
        if loss > 0:
            self.strategies[strategy].current_debt -= loss
            self.total_debt -= loss
    
        # NOTE: should be precise (no new unlocked shares due to above's burn of shares)
        # newly_locked_shares have already been minted / transferred to the vault, so they need to be subtracted
        # no risk of underflow because they have just been minted.
        previously_locked_shares: uint256 = self.balance_of[self] - newly_locked_shares
    
        # Now that pps has updated, we can burn the shares we intended to burn as a result of losses/fees.
        # NOTE: If a value reduction (losses / fees) has occurred, prioritize burning locked profit to avoid
        # negative impact on price per share. Price per share is reduced only if losses exceed locked value.
        if shares_to_burn > 0:
            # Cant burn more than the vault owns.
            shares_to_burn = min(shares_to_burn, previously_locked_shares + newly_locked_shares)
            self._burn_shares(shares_to_burn, self)
    
            # We burn first the newly locked shares, then the previously locked shares.
            shares_not_to_lock: uint256 = min(shares_to_burn, newly_locked_shares)
            # Reduce the amounts to lock by how much we burned
            newly_locked_shares -= shares_not_to_lock
            previously_locked_shares -= (shares_to_burn - shares_not_to_lock)
    
        # Issue shares for fees that were calculated above if applicable.
        if accountant_fees_shares > 0:
            self._issue_shares(accountant_fees_shares, accountant)
    
        if protocol_fees_shares > 0:
            self._issue_shares(protocol_fees_shares, protocol_fee_recipient)
    
        # Update unlocking rate and time to fully unlocked.
        total_locked_shares: uint256 = previously_locked_shares + newly_locked_shares
        if total_locked_shares > 0:
            previously_locked_time: uint256 = 0
            _full_profit_unlock_date: uint256 = self.full_profit_unlock_date
            # Check if we need to account for shares still unlocking.
            if _full_profit_unlock_date > block.timestamp: 
                # There will only be previously locked shares if time remains.
                # We calculate this here since it will not occur every time we lock shares.
                previously_locked_time = previously_locked_shares * (_full_profit_unlock_date - block.timestamp)
    
            # new_profit_locking_period is a weighted average between the remaining time of the previously locked shares and the profit_max_unlock_time
            new_profit_locking_period: uint256 = (previously_locked_time + newly_locked_shares * profit_max_unlock_time) / total_locked_shares
            # Calculate how many shares unlock per second.
            self.profit_unlocking_rate = total_locked_shares * MAX_BPS_EXTENDED / new_profit_locking_period
            # Calculate how long until the full amount of shares is unlocked.
            self.full_profit_unlock_date = block.timestamp + new_profit_locking_period
            # Update the last profitable report timestamp.
            self.last_profit_update = block.timestamp
    
        else:
            # NOTE: only setting this to 0 will turn in the desired effect, no need 
            # to update last_profit_update or full_profit_unlock_date
            self.profit_unlocking_rate = 0
    
        # Record the report of profit timestamp.
        self.strategies[strategy].last_report = block.timestamp
    
        # We have to recalculate the fees paid for cases with an overall loss.
        log StrategyReported(
            strategy,
            gain,
            loss,
            self.strategies[strategy].current_debt,
            self._convert_to_assets(protocol_fees_shares, Rounding.ROUND_DOWN),
            self._convert_to_assets(protocol_fees_shares + accountant_fees_shares, Rounding.ROUND_DOWN),
            total_refunds
        )
    
        return (gain, loss)
    
    # SETTERS #
    @external
    def set_accountant(new_accountant: address):
        """
        @notice Set the new accountant address.
        @param new_accountant The new accountant address.
        """
        self._enforce_role(msg.sender, Roles.ACCOUNTANT_MANAGER)
        self.accountant = new_accountant
    
        log UpdateAccountant(new_accountant)
    
    @external
    def set_default_queue(new_default_queue: DynArray[address, MAX_QUEUE]):
        """
        @notice Set the new default queue array.
        @dev Will check each strategy to make sure it is active.
        @param new_default_queue The new default queue array.
        """
        self._enforce_role(msg.sender, Roles.QUEUE_MANAGER)
    
        # Make sure every strategy in the new queue is active.
        for strategy in new_default_queue:
            assert self.strategies[strategy].activation != 0, "!inactive"
    
        # Save the new queue.
        self.default_queue = new_default_queue
    
        log UpdateDefaultQueue(new_default_queue)
    
    @external
    def set_use_default_queue(use_default_queue: bool):
        """
        @notice Set a new value for `use_default_queue`.
        @dev If set `True` the default queue will always be
            used no matter whats passed in.
        @param use_default_queue new value.
        """
        self._enforce_role(msg.sender, Roles.QUEUE_MANAGER)
        self.use_default_queue = use_default_queue
    
        log UpdateUseDefaultQueue(use_default_queue)
    
    @external
    def set_deposit_limit(deposit_limit: uint256):
        """
        @notice Set the new deposit limit.
        @dev Can not be changed if a deposit_limit_module
        is set or if shutdown.
        @param deposit_limit The new deposit limit.
        """
        assert self.shutdown == False # Dev: shutdown
        self._enforce_role(msg.sender, Roles.DEPOSIT_LIMIT_MANAGER)
        assert self.deposit_limit_module == empty(address), "using module"
    
        self.deposit_limit = deposit_limit
    
        log UpdateDepositLimit(deposit_limit)
    
    @external
    def set_deposit_limit_module(deposit_limit_module: address):
        """
        @notice Set a contract to handle the deposit limit.
        @dev The default `deposit_limit` will need to be set to
        max uint256 since the module will override it.
        @param deposit_limit_module Address of the module.
        """
        assert self.shutdown == False # Dev: shutdown
        self._enforce_role(msg.sender, Roles.DEPOSIT_LIMIT_MANAGER)
        assert self.deposit_limit == max_value(uint256), "using deposit limit"
    
        self.deposit_limit_module = deposit_limit_module
    
        log UpdateDepositLimitModule(deposit_limit_module)
    
    @external
    def set_withdraw_limit_module(withdraw_limit_module: address):
        """
        @notice Set a contract to handle the withdraw limit.
        @dev This will override the default `max_withdraw`.
        @param withdraw_limit_module Address of the module.
        """
        self._enforce_role(msg.sender, Roles.WITHDRAW_LIMIT_MANAGER)
    
        self.withdraw_limit_module = withdraw_limit_module
    
        log UpdateWithdrawLimitModule(withdraw_limit_module)
    
    @external
    def set_minimum_total_idle(minimum_total_idle: uint256):
        """
        @notice Set the new minimum total idle.
        @param minimum_total_idle The new minimum total idle.
        """
        self._enforce_role(msg.sender, Roles.MINIMUM_IDLE_MANAGER)
        self.minimum_total_idle = minimum_total_idle
    
        log UpdateMinimumTotalIdle(minimum_total_idle)
    
    @external
    def setProfitMaxUnlockTime(new_profit_max_unlock_time: uint256):
        """
        @notice Set the new profit max unlock time.
        @dev The time is denominated in seconds and must be less than 1 year.
            We only need to update locking period if setting to 0,
            since the current period will use the old rate and on the next
            report it will be reset with the new unlocking time.
        
            Setting to 0 will cause any currently locked profit to instantly
            unlock and an immediate increase in the vaults Price Per Share.
    
        @param new_profit_max_unlock_time The new profit max unlock time.
        """
        self._enforce_role(msg.sender, Roles.PROFIT_UNLOCK_MANAGER)
        # Must be less than one year for report cycles
        assert new_profit_max_unlock_time <= 31_556_952, "profit unlock time too long"
    
        # If setting to 0 we need to reset any locked values.
        if (new_profit_max_unlock_time == 0):
            # Burn any shares the vault still has.
            self._burn_shares(self.balance_of[self], self)
            # Reset unlocking variables to 0.
            self.profit_unlocking_rate = 0
            self.full_profit_unlock_date = 0
    
        self.profit_max_unlock_time = new_profit_max_unlock_time
    
        log UpdateProfitMaxUnlockTime(new_profit_max_unlock_time)
    
    # ROLE MANAGEMENT #
    @internal
    def _enforce_role(account: address, role: Roles):
        # Make sure the sender either holds the role or it has been opened.
        assert role in self.roles[account] or self.open_roles[role], "not allowed"
    
    @external
    def set_role(account: address, role: Roles):
        """
        @notice Set the roles for an account.
        @dev This will fully override an accounts current roles
         so it should include all roles the account should hold.
        @param account The account to set the role for.
        @param role The roles the account should hold.
        """
        assert msg.sender == self.role_manager
        self.roles[account] = role
    
        log RoleSet(account, role)
    
    @external
    def add_role(account: address, role: Roles):
        """
        @notice Add a new role to an address.
        @dev This will add a new role to the account
         without effecting any of the previously held roles.
        @param account The account to add a role to.
        @param role The new role to add to account.
        """
        assert msg.sender == self.role_manager
        self.roles[account] = self.roles[account] | role
    
        log RoleSet(account, self.roles[account])
    
    @external
    def remove_role(account: address, role: Roles):
        """
        @notice Remove a single role from an account.
        @dev This will leave all other roles for the 
         account unchanged.
        @param account The account to remove a Role from.
        @param role The Role to remove.
        """
        assert msg.sender == self.role_manager
        self.roles[account] = self.roles[account] & ~role
    
        log RoleSet(account, self.roles[account])
    
    @external
    def set_open_role(role: Roles):
        """
        @notice Set a role to be open.
        @param role The role to set.
        """
        assert msg.sender == self.role_manager
        self.open_roles[role] = True
    
        log RoleStatusChanged(role, RoleStatusChange.OPENED)
    
    @external
    def close_open_role(role: Roles):
        """
        @notice Close a opened role.
        @param role The role to close.
        """
        assert msg.sender == self.role_manager
        self.open_roles[role] = False
    
        log RoleStatusChanged(role, RoleStatusChange.CLOSED)
        
    @external
    def transfer_role_manager(role_manager: address):
        """
        @notice Step 1 of 2 in order to transfer the 
            role manager to a new address. This will set
            the future_role_manager. Which will then need
            to be accepted by the new manager.
        @param role_manager The new role manager address.
        """
        assert msg.sender == self.role_manager
        self.future_role_manager = role_manager
    
    @external
    def accept_role_manager():
        """
        @notice Accept the role manager transfer.
        """
        assert msg.sender == self.future_role_manager
        self.role_manager = msg.sender
        self.future_role_manager = empty(address)
    
        log UpdateRoleManager(msg.sender)
    
    # VAULT STATUS VIEWS
    
    @view
    @external
    def isShutdown() -> bool:
        """
        @notice Get if the vault is shutdown.
        @return Bool representing the shutdown status
        """
        return self.shutdown
    @view
    @external
    def unlockedShares() -> uint256:
        """
        @notice Get the amount of shares that have been unlocked.
        @return The amount of shares that are have been unlocked.
        """
        return self._unlocked_shares()
    
    @view
    @external
    def pricePerShare() -> uint256:
        """
        @notice Get the price per share (pps) of the vault.
        @dev This value offers limited precision. Integrations that require 
            exact precision should use convertToAssets or convertToShares instead.
        @return The price per share.
        """
        return self._convert_to_assets(10 ** DECIMALS, Rounding.ROUND_DOWN)
    
    @view
    @external
    def get_default_queue() -> DynArray[address, MAX_QUEUE]:
        """
        @notice Get the full default queue currently set.
        @return The current default withdrawal queue.
        """
        return self.default_queue
    
    ## REPORTING MANAGEMENT ##
    @external
    @nonreentrant("lock")
    def process_report(strategy: address) -> (uint256, uint256):
        """
        @notice Process the report of a strategy.
        @param strategy The strategy to process the report for.
        @return The gain and loss of the strategy.
        """
        self._enforce_role(msg.sender, Roles.REPORTING_MANAGER)
        return self._process_report(strategy)
    
    @external
    @nonreentrant("lock")
    def buy_debt(strategy: address, amount: uint256):
        """
        @notice Used for governance to buy bad debt from the vault.
        @dev This should only ever be used in an emergency in place
        of force revoking a strategy in order to not report a loss.
        It allows the DEBT_PURCHASER role to buy the strategies debt
        for an equal amount of `asset`. 
    
        @param strategy The strategy to buy the debt for
        @param amount The amount of debt to buy from the vault.
        """
        self._enforce_role(msg.sender, Roles.DEBT_PURCHASER)
        assert self.strategies[strategy].activation != 0, "not active"
        
        # Cache the current debt.
        current_debt: uint256 = self.strategies[strategy].current_debt
        _amount: uint256 = amount
    
        assert current_debt > 0, "nothing to buy"
        assert _amount > 0, "nothing to buy with"
        
        if _amount > current_debt:
            _amount = current_debt
    
        # We get the proportion of the debt that is being bought and
        # transfer the equivalent shares. We assume this is being used
        # due to strategy issues so won't rely on its conversion rates.
        shares: uint256 = IStrategy(strategy).balanceOf(self) * _amount / current_debt
    
        assert shares > 0, "cannot buy zero"
    
        self._erc20_safe_transfer_from(ASSET.address, msg.sender, self, _amount)
    
        # Lower strategy debt
        self.strategies[strategy].current_debt -= _amount
        # lower total debt
        self.total_debt -= _amount
        # Increase total idle
        self.total_idle += _amount
    
        # log debt change
        log DebtUpdated(strategy, current_debt, current_debt - _amount)
    
        # Transfer the strategies shares out.
        self._erc20_safe_transfer(strategy, msg.sender, shares)
    
        log DebtPurchased(strategy, _amount)
    
    ## STRATEGY MANAGEMENT ##
    @external
    def add_strategy(new_strategy: address):
        """
        @notice Add a new strategy.
        @param new_strategy The new strategy to add.
        """
        self._enforce_role(msg.sender, Roles.ADD_STRATEGY_MANAGER)
        self._add_strategy(new_strategy)
    
    @external
    def revoke_strategy(strategy: address):
        """
        @notice Revoke a strategy.
        @param strategy The strategy to revoke.
        """
        self._enforce_role(msg.sender, Roles.REVOKE_STRATEGY_MANAGER)
        self._revoke_strategy(strategy)
    
    @external
    def force_revoke_strategy(strategy: address):
        """
        @notice Force revoke a strategy.
        @dev The vault will remove the strategy and write off any debt left 
            in it as a loss. This function is a dangerous function as it can force a 
            strategy to take a loss. All possible assets should be removed from the 
            strategy first via update_debt. If a strategy is removed erroneously it 
            can be re-added and the loss will be credited as profit. Fees will apply.
        @param strategy The strategy to force revoke.
        """
        self._enforce_role(msg.sender, Roles.FORCE_REVOKE_MANAGER)
        self._revoke_strategy(strategy, True)
    
    ## DEBT MANAGEMENT ##
    @external
    def update_max_debt_for_strategy(strategy: address, new_max_debt: uint256):
        """
        @notice Update the max debt for a strategy.
        @param strategy The strategy to update the max debt for.
        @param new_max_debt The new max debt for the strategy.
        """
        self._enforce_role(msg.sender, Roles.MAX_DEBT_MANAGER)
        assert self.strategies[strategy].activation != 0, "inactive strategy"
        self.strategies[strategy].max_debt = new_max_debt
    
        log UpdatedMaxDebtForStrategy(msg.sender, strategy, new_max_debt)
    
    @external
    @nonreentrant("lock")
    def update_debt(strategy: address, target_debt: uint256) -> uint256:
        """
        @notice Update the debt for a strategy.
        @param strategy The strategy to update the debt for.
        @param target_debt The target debt for the strategy.
        @return The amount of debt added or removed.
        """
        self._enforce_role(msg.sender, Roles.DEBT_MANAGER)
        return self._update_debt(strategy, target_debt)
    
    ## EMERGENCY MANAGEMENT ##
    @external
    def shutdown_vault():
        """
        @notice Shutdown the vault.
        """
        self._enforce_role(msg.sender, Roles.EMERGENCY_MANAGER)
        assert self.shutdown == False
        
        # Shutdown the vault.
        self.shutdown = True
    
        # Set deposit limit to 0.
        if self.deposit_limit_module != empty(address):
            self.deposit_limit_module = empty(address)
    
            log UpdateDepositLimitModule(empty(address))
    
        self.deposit_limit = 0
        log UpdateDepositLimit(0)
    
        self.roles[msg.sender] = self.roles[msg.sender] | Roles.DEBT_MANAGER
        log Shutdown()
    
    
    ## SHARE MANAGEMENT ##
    ## ERC20 + ERC4626 ##
    @external
    @nonreentrant("lock")
    def deposit(assets: uint256, receiver: address) -> uint256:
        """
        @notice Deposit assets into the vault.
        @param assets The amount of assets to deposit.
        @param receiver The address to receive the shares.
        @return The amount of shares minted.
        """
        return self._deposit(msg.sender, receiver, assets)
    
    @external
    @nonreentrant("lock")
    def mint(shares: uint256, receiver: address) -> uint256:
        """
        @notice Mint shares for the receiver.
        @param shares The amount of shares to mint.
        @param receiver The address to receive the shares.
        @return The amount of assets deposited.
        """
        return self._mint(msg.sender, receiver, shares)
    
    @external
    @nonreentrant("lock")
    def withdraw(
        assets: uint256, 
        receiver: address, 
        owner: address, 
        max_loss: uint256 = 0,
        strategies: DynArray[address, MAX_QUEUE] = []
    ) -> uint256:
        """
        @notice Withdraw an amount of asset to `receiver` burning `owner`s shares.
        @dev The default behavior is to not allow any loss.
        @param assets The amount of asset to withdraw.
        @param receiver The address to receive the assets.
        @param owner The address who's shares are being burnt.
        @param max_loss Optional amount of acceptable loss in Basis Points.
        @param strategies Optional array of strategies to withdraw from.
        @return The amount of shares actually burnt.
        """
        shares: uint256 = self._convert_to_shares(assets, Rounding.ROUND_UP)
        self._redeem(msg.sender, receiver, owner, assets, shares, max_loss, strategies)
        return shares
    
    @external
    @nonreentrant("lock")
    def redeem(
        shares: uint256, 
        receiver: address, 
        owner: address, 
        max_loss: uint256 = MAX_BPS,
        strategies: DynArray[address, MAX_QUEUE] = []
    ) -> uint256:
        """
        @notice Redeems an amount of shares of `owners` shares sending funds to `receiver`.
        @dev The default behavior is to allow losses to be realized.
        @param shares The amount of shares to burn.
        @param receiver The address to receive the assets.
        @param owner The address who's shares are being burnt.
        @param max_loss Optional amount of acceptable loss in Basis Points.
        @param strategies Optional array of strategies to withdraw from.
        @return The amount of assets actually withdrawn.
        """
        assets: uint256 = self._convert_to_assets(shares, Rounding.ROUND_DOWN)
        # Always return the actual amount of assets withdrawn.
        return self._redeem(msg.sender, receiver, owner, assets, shares, max_loss, strategies)
    
    
    @external
    def approve(spender: address, amount: uint256) -> bool:
        """
        @notice Approve an address to spend the vault's shares.
        @param spender The address to approve.
        @param amount The amount of shares to approve.
        @return True if the approval was successful.
        """
        return self._approve(msg.sender, spender, amount)
    
    @external
    def transfer(receiver: address, amount: uint256) -> bool:
        """
        @notice Transfer shares to a receiver.
        @param receiver The address to transfer shares to.
        @param amount The amount of shares to transfer.
        @return True if the transfer was successful.
        """
        assert receiver not in [self, empty(address)]
        self._transfer(msg.sender, receiver, amount)
        return True
    
    @external
    def transferFrom(sender: address, receiver: address, amount: uint256) -> bool:
        """
        @notice Transfer shares from a sender to a receiver.
        @param sender The address to transfer shares from.
        @param receiver The address to transfer shares to.
        @param amount The amount of shares to transfer.
        @return True if the transfer was successful.
        """
        assert receiver not in [self, empty(address)]
        return self._transfer_from(sender, receiver, amount)
    
    ## ERC20+4626 compatibility
    @external
    def increaseAllowance(spender: address, amount: uint256) -> bool:
        """
        @notice Increase the allowance for a spender.
        @param spender The address to increase the allowance for.
        @param amount The amount to increase the allowance by.
        @return True if the increase was successful.
        """
        return self._increase_allowance(msg.sender, spender, amount)
    
    @external
    def decreaseAllowance(spender: address, amount: uint256) -> bool:
        """
        @notice Decrease the allowance for a spender.
        @param spender The address to decrease the allowance for.
        @param amount The amount to decrease the allowance by.
        @return True if the decrease was successful.
        """
        return self._decrease_allowance(msg.sender, spender, amount)
    
    @external
    def permit(
        owner: address, 
        spender: address, 
        amount: uint256, 
        deadline: uint256, 
        v: uint8, 
        r: bytes32, 
        s: bytes32
    ) -> bool:
        """
        @notice Approve an address to spend the vault's shares.
        @param owner The address to approve.
        @param spender The address to approve.
        @param amount The amount of shares to approve.
        @param deadline The deadline for the permit.
        @param v The v component of the signature.
        @param r The r component of the signature.
        @param s The s component of the signature.
        @return True if the approval was successful.
        """
        return self._permit(owner, spender, amount, deadline, v, r, s)
    
    @view
    @external
    def balanceOf(addr: address) -> uint256:
        """
        @notice Get the balance of a user.
        @param addr The address to get the balance of.
        @return The balance of the user.
        """
        if(addr == self):
            # If the address is the vault, account for locked shares.
            return self.balance_of[addr] - self._unlocked_shares()
    
        return self.balance_of[addr]
    
    @view
    @external
    def totalSupply() -> uint256:
        """
        @notice Get the total supply of shares.
        @return The total supply of shares.
        """
        return self._total_supply()
    
    @view
    @external
    def asset() -> address:
        """
        @notice Get the address of the asset.
        @return The address of the asset.
        """
        return ASSET.address
    
    @view
    @external
    def decimals() -> uint8:
        """
        @notice Get the number of decimals of the asset/share.
        @return The number of decimals of the asset/share.
        """
        return convert(DECIMALS, uint8)
    
    @view
    @external
    def totalAssets() -> uint256:
        """
        @notice Get the total assets held by the vault.
        @return The total assets held by the vault.
        """
        return self._total_assets()
    
    @view
    @external
    def totalIdle() -> uint256:
        """
        @notice Get the amount of loose `asset` the vault holds.
        @return The current total idle.
        """
        return self.total_idle
    
    @view
    @external
    def totalDebt() -> uint256:
        """
        @notice Get the the total amount of funds invested
        across all strategies.
        @return The current total debt.
        """
        return self.total_debt
    
    @view
    @external
    def convertToShares(assets: uint256) -> uint256:
        """
        @notice Convert an amount of assets to shares.
        @param assets The amount of assets to convert.
        @return The amount of shares.
        """
        return self._convert_to_shares(assets, Rounding.ROUND_DOWN)
    
    @view
    @external
    def previewDeposit(assets: uint256) -> uint256:
        """
        @notice Preview the amount of shares that would be minted for a deposit.
        @param assets The amount of assets to deposit.
        @return The amount of shares that would be minted.
        """
        return self._convert_to_shares(assets, Rounding.ROUND_DOWN)
    
    @view
    @external
    def previewMint(shares: uint256) -> uint256:
        """
        @notice Preview the amount of assets that would be deposited for a mint.
        @param shares The amount of shares to mint.
        @return The amount of assets that would be deposited.
        """
        return self._convert_to_assets(shares, Rounding.ROUND_UP)
    
    @view
    @external
    def convertToAssets(shares: uint256) -> uint256:
        """
        @notice Convert an amount of shares to assets.
        @param shares The amount of shares to convert.
        @return The amount of assets.
        """
        return self._convert_to_assets(shares, Rounding.ROUND_DOWN)
    
    @view
    @external
    def maxDeposit(receiver: address) -> uint256:
        """
        @notice Get the maximum amount of assets that can be deposited.
        @param receiver The address that will receive the shares.
        @return The maximum amount of assets that can be deposited.
        """
        return self._max_deposit(receiver)
    
    @view
    @external
    def maxMint(receiver: address) -> uint256:
        """
        @notice Get the maximum amount of shares that can be minted.
        @param receiver The address that will receive the shares.
        @return The maximum amount of shares that can be minted.
        """
        max_deposit: uint256 = self._max_deposit(receiver)
        return self._convert_to_shares(max_deposit, Rounding.ROUND_DOWN)
    
    @view
    @external
    def maxWithdraw(
        owner: address,
        max_loss: uint256 = 0,
        strategies: DynArray[address, MAX_QUEUE] = []
    ) -> uint256:
        """
        @notice Get the maximum amount of assets that can be withdrawn.
        @dev Complies to normal 4626 interface and takes custom params.
        @param owner The address that owns the shares.
        @param max_loss Custom max_loss if any.
        @param strategies Custom strategies queue if any.
        @return The maximum amount of assets that can be withdrawn.
        """
        return self._max_withdraw(owner, max_loss, strategies)
    
    @view
    @external
    def maxRedeem(
        owner: address,
        max_loss: uint256 = MAX_BPS,
        strategies: DynArray[address, MAX_QUEUE] = []
    ) -> uint256:
        """
        @notice Get the maximum amount of shares that can be redeemed.
        @dev Complies to normal 4626 interface and takes custom params.
        @param owner The address that owns the shares.
        @param max_loss Custom max_loss if any.
        @param strategies Custom strategies queue if any.
        @return The maximum amount of shares that can be redeemed.
        """
        return min(
            # Convert to shares is rounding up so we check against the full balance.
            self._convert_to_shares(self._max_withdraw(owner, max_loss, strategies), Rounding.ROUND_UP),
            self.balance_of[owner]
        )
    
    @view
    @external
    def previewWithdraw(assets: uint256) -> uint256:
        """
        @notice Preview the amount of shares that would be redeemed for a withdraw.
        @param assets The amount of assets to withdraw.
        @return The amount of shares that would be redeemed.
        """
        return self._convert_to_shares(assets, Rounding.ROUND_UP)
    
    @view
    @external
    def previewRedeem(shares: uint256) -> uint256:
        """
        @notice Preview the amount of assets that would be withdrawn for a redeem.
        @param shares The amount of shares to redeem.
        @return The amount of assets that would be withdrawn.
        """
        return self._convert_to_assets(shares, Rounding.ROUND_DOWN)
    
    @view
    @external
    def apiVersion() -> String[28]:
        """
        @notice Get the API version of the vault.
        @return The API version of the vault.
        """
        return API_VERSION
    
    @view
    @external
    def assess_share_of_unrealised_losses(strategy: address, assets_needed: uint256) -> uint256:
        """
        @notice Assess the share of unrealised losses that a strategy has.
        @param strategy The address of the strategy.
        @param assets_needed The amount of assets needed to be withdrawn.
        @return The share of unrealised losses that the strategy has.
        """
        assert self.strategies[strategy].current_debt >= assets_needed
    
        return self._assess_share_of_unrealised_losses(strategy, assets_needed)
    
    ## Profit locking getter functions ##
    
    @view
    @external
    def profitMaxUnlockTime() -> uint256:
        """
        @notice Gets the current time profits are set to unlock over.
        @return The current profit max unlock time.
        """
        return self.profit_max_unlock_time
    
    @view
    @external
    def fullProfitUnlockDate() -> uint256:
        """
        @notice Gets the timestamp at which all profits will be unlocked.
        @return The full profit unlocking timestamp
        """
        return self.full_profit_unlock_date
    
    @view
    @external
    def profitUnlockingRate() -> uint256:
        """
        @notice The per second rate at which profits are unlocking.
        @dev This is denominated in EXTENDED_BPS decimals.
        @return The current profit unlocking rate.
        """
        return self.profit_unlocking_rate
    
    
    @view
    @external
    def lastProfitUpdate() -> uint256:
        """
        @notice The timestamp of the last time shares were locked.
        @return The last profit update.
        """
        return self.last_profit_update
    
    # eip-1344
    @view
    @internal
    def domain_separator() -> bytes32:
        return keccak256(
            concat(
                DOMAIN_TYPE_HASH,
                keccak256(convert("Yearn Vault", Bytes[11])),
                keccak256(convert(API_VERSION, Bytes[28])),
                convert(chain.id, bytes32),
                convert(self, bytes32)
            )
        )
    
    @view
    @external
    def DOMAIN_SEPARATOR() -> bytes32:
        """
        @notice Get the domain separator.
        @return The domain separator.
        """
        return self.domain_separator()

    File 2 of 2: DebtToken
    // SPDX-License-Identifier: MIT
    pragma solidity 0.8.19;
    import { OFT, IERC20, ERC20 } from "OFT.sol";
    import { IERC3156FlashBorrower } from "IERC3156FlashBorrower.sol";
    import "IPrismaCore.sol";
    /**
        @title Prisma Debt Token "acUSD"
        @notice CDP minted against collateral deposits within `TroveManager`.
                This contract has a 1:n relationship with multiple deployments of `TroveManager`,
                each of which hold one collateral type which may be used to mint this token.
     */
    contract DebtToken is OFT {
        string public constant version = "1";
        // --- ERC 3156 Data ---
        bytes32 private constant _RETURN_VALUE = keccak256("ERC3156FlashBorrower.onFlashLoan");
        uint256 public constant FLASH_LOAN_FEE = 9; // 1 = 0.0001%
        // --- Data for EIP2612 ---
        // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
        bytes32 public constant permitTypeHash = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
        // keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
        bytes32 private constant _TYPE_HASH = 0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f;
        // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
        // invalidate the cached domain separator if the chain id changes.
        bytes32 private immutable _CACHED_DOMAIN_SEPARATOR;
        uint256 private immutable _CACHED_CHAIN_ID;
        bytes32 private immutable _HASHED_NAME;
        bytes32 private immutable _HASHED_VERSION;
        mapping(address => uint256) private _nonces;
        // --- Addresses ---
        IPrismaCore private immutable _prismaCore;
        address public immutable stabilityPoolAddress;
        address public immutable borrowerOperationsAddress;
        address public immutable factory;
        address public immutable gasPool;
        mapping(address => bool) public troveManager;
        // Amount of debt to be locked in gas pool on opening troves
        uint256 public immutable DEBT_GAS_COMPENSATION;
        constructor(
            string memory _name,
            string memory _symbol,
            address _stabilityPoolAddress,
            address _borrowerOperationsAddress,
            IPrismaCore prismaCore_,
            address _layerZeroEndpoint,
            address _factory,
            address _gasPool,
            uint256 _gasCompensation
        ) OFT(_name, _symbol, _layerZeroEndpoint) {
            stabilityPoolAddress = _stabilityPoolAddress;
            _prismaCore = prismaCore_;
            borrowerOperationsAddress = _borrowerOperationsAddress;
            factory = _factory;
            gasPool = _gasPool;
            DEBT_GAS_COMPENSATION = _gasCompensation;
            bytes32 hashedName = keccak256(bytes(_name));
            bytes32 hashedVersion = keccak256(bytes(version));
            _HASHED_NAME = hashedName;
            _HASHED_VERSION = hashedVersion;
            _CACHED_CHAIN_ID = block.chainid;
            _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(_TYPE_HASH, hashedName, hashedVersion);
        }
        function enableTroveManager(address _troveManager) external {
            require(msg.sender == factory, "!Factory");
            troveManager[_troveManager] = true;
        }
        // --- Functions for intra-Prisma calls ---
        function mintWithGasCompensation(address _account, uint256 _amount) external returns (bool) {
            require(msg.sender == borrowerOperationsAddress);
            _mint(_account, _amount);
            _mint(gasPool, DEBT_GAS_COMPENSATION);
            return true;
        }
        function burnWithGasCompensation(address _account, uint256 _amount) external returns (bool) {
            require(msg.sender == borrowerOperationsAddress);
            _burn(_account, _amount);
            _burn(gasPool, DEBT_GAS_COMPENSATION);
            return true;
        }
        function mint(address _account, uint256 _amount) external {
            require(msg.sender == borrowerOperationsAddress || troveManager[msg.sender], "Debt: Caller not BO/TM");
            _mint(_account, _amount);
        }
        function burn(address _account, uint256 _amount) external {
            require(troveManager[msg.sender], "Debt: Caller not TroveManager");
            _burn(_account, _amount);
        }
        function sendToSP(address _sender, uint256 _amount) external {
            require(msg.sender == stabilityPoolAddress, "Debt: Caller not StabilityPool");
            _transfer(_sender, msg.sender, _amount);
        }
        function returnFromPool(address _poolAddress, address _receiver, uint256 _amount) external {
            require(msg.sender == stabilityPoolAddress || troveManager[msg.sender], "Debt: Caller not TM/SP");
            _transfer(_poolAddress, _receiver, _amount);
        }
        // --- External functions ---
        function transfer(address recipient, uint256 amount) public override(IERC20, ERC20) returns (bool) {
            _requireValidRecipient(recipient);
            return super.transfer(recipient, amount);
        }
        function transferFrom(
            address sender,
            address recipient,
            uint256 amount
        ) public override(IERC20, ERC20) returns (bool) {
            _requireValidRecipient(recipient);
            return super.transferFrom(sender, recipient, amount);
        }
        // --- ERC 3156 Functions ---
        /**
         * @dev Returns the maximum amount of tokens available for loan.
         * @param token The address of the token that is requested.
         * @return The amount of token that can be loaned.
         */
        function maxFlashLoan(address token) public view returns (uint256) {
            return token == address(this) ? type(uint256).max - totalSupply() : 0;
        }
        /**
         * @dev Returns the fee applied when doing flash loans. This function calls
         * the {_flashFee} function which returns the fee applied when doing flash
         * loans.
         * @param token The token to be flash loaned.
         * @param amount The amount of tokens to be loaned.
         * @return The fees applied to the corresponding flash loan.
         */
        function flashFee(address token, uint256 amount) external view returns (uint256) {
            return token == address(this) ? _flashFee(amount) : 0;
        }
        /**
         * @dev Returns the fee applied when doing flash loans. By default this
         * implementation has 0 fees. This function can be overloaded to make
         * the flash loan mechanism deflationary.
         * @param amount The amount of tokens to be loaned.
         * @return The fees applied to the corresponding flash loan.
         */
        function _flashFee(uint256 amount) internal pure returns (uint256) {
            return (amount * FLASH_LOAN_FEE) / 10000;
        }
        /**
         * @dev Performs a flash loan. New tokens are minted and sent to the
         * `receiver`, who is required to implement the {IERC3156FlashBorrower}
         * interface. By the end of the flash loan, the receiver is expected to own
         * amount + fee tokens and have them approved back to the token contract itself so
         * they can be burned.
         * @param receiver The receiver of the flash loan. Should implement the
         * {IERC3156FlashBorrower-onFlashLoan} interface.
         * @param token The token to be flash loaned. Only `address(this)` is
         * supported.
         * @param amount The amount of tokens to be loaned.
         * @param data An arbitrary datafield that is passed to the receiver.
         * @return `true` if the flash loan was successful.
         */
        // This function can reenter, but it doesn't pose a risk because it always preserves the property that the amount
        // minted at the beginning is always recovered and burned at the end, or else the entire function will revert.
        // slither-disable-next-line reentrancy-no-eth
        function flashLoan(
            IERC3156FlashBorrower receiver,
            address token,
            uint256 amount,
            bytes calldata data
        ) external returns (bool) {
            require(token == address(this), "ERC20FlashMint: wrong token");
            require(amount <= maxFlashLoan(token), "ERC20FlashMint: amount exceeds maxFlashLoan");
            uint256 fee = _flashFee(amount);
            _mint(address(receiver), amount);
            require(
                receiver.onFlashLoan(msg.sender, token, amount, fee, data) == _RETURN_VALUE,
                "ERC20FlashMint: invalid return value"
            );
            _spendAllowance(address(receiver), address(this), amount + fee);
            _burn(address(receiver), amount);
            _transfer(address(receiver), _prismaCore.feeReceiver(), fee);
            return true;
        }
        // --- EIP 2612 Functionality ---
        function domainSeparator() public view returns (bytes32) {
            if (block.chainid == _CACHED_CHAIN_ID) {
                return _CACHED_DOMAIN_SEPARATOR;
            } else {
                return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);
            }
        }
        function permit(
            address owner,
            address spender,
            uint256 amount,
            uint256 deadline,
            uint8 v,
            bytes32 r,
            bytes32 s
        ) external {
            require(deadline >= block.timestamp, "Debt: expired deadline");
            bytes32 digest = keccak256(
                abi.encodePacked(
                    "\\x19\\x01",
                    domainSeparator(),
                    keccak256(abi.encode(permitTypeHash, owner, spender, amount, _nonces[owner]++, deadline))
                )
            );
            address recoveredAddress = ecrecover(digest, v, r, s);
            require(recoveredAddress == owner, "Debt: invalid signature");
            _approve(owner, spender, amount);
        }
        function nonces(address owner) external view returns (uint256) {
            // FOR EIP 2612
            return _nonces[owner];
        }
        // --- Internal operations ---
        function _buildDomainSeparator(bytes32 typeHash, bytes32 name_, bytes32 version_) private view returns (bytes32) {
            return keccak256(abi.encode(typeHash, name_, version_, block.chainid, address(this)));
        }
        // --- 'require' functions ---
        function _requireValidRecipient(address _recipient) internal view {
            require(
                _recipient != address(0) && _recipient != address(this),
                "Debt: Cannot transfer tokens directly to the Debt token contract or the zero address"
            );
            require(
                _recipient != stabilityPoolAddress && !troveManager[_recipient] && _recipient != borrowerOperationsAddress,
                "Debt: Cannot transfer tokens directly to the StabilityPool, TroveManager or BorrowerOps"
            );
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    import "ERC20.sol";
    import "IERC165.sol";
    import "IOFT.sol";
    import "OFTCore.sol";
    // override decimal() function is needed
    contract OFT is OFTCore, ERC20, IOFT {
        constructor(string memory _name, string memory _symbol, address _lzEndpoint) ERC20(_name, _symbol) OFTCore(_lzEndpoint) {}
        function supportsInterface(bytes4 interfaceId) public view virtual override(OFTCore, IERC165) returns (bool) {
            return interfaceId == type(IOFT).interfaceId || interfaceId == type(IERC20).interfaceId || super.supportsInterface(interfaceId);
        }
        function token() public view virtual override returns (address) {
            return address(this);
        }
        function circulatingSupply() public view virtual override returns (uint) {
            return totalSupply();
        }
        function _debitFrom(address _from, uint16, bytes memory, uint _amount) internal virtual override returns(uint) {
            address spender = _msgSender();
            if (_from != spender) _spendAllowance(_from, spender, _amount);
            _burn(_from, _amount);
            return _amount;
        }
        function _creditTo(uint16, address _toAddress, uint _amount) internal virtual override returns(uint) {
            _mint(_toAddress, _amount);
            return _amount;
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/ERC20.sol)
    pragma solidity ^0.8.0;
    import "IERC20.sol";
    import "IERC20Metadata.sol";
    import "Context.sol";
    /**
     * @dev Implementation of the {IERC20} interface.
     *
     * This implementation is agnostic to the way tokens are created. This means
     * that a supply mechanism has to be added in a derived contract using {_mint}.
     * For a generic mechanism see {ERC20PresetMinterPauser}.
     *
     * TIP: For a detailed writeup see our guide
     * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
     * to implement supply mechanisms].
     *
     * We have followed general OpenZeppelin Contracts guidelines: functions revert
     * instead returning `false` on failure. This behavior is nonetheless
     * conventional and does not conflict with the expectations of ERC20
     * applications.
     *
     * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
     * This allows applications to reconstruct the allowance for all accounts just
     * by listening to said events. Other implementations of the EIP may not emit
     * these events, as it isn't required by the specification.
     *
     * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
     * functions have been added to mitigate the well-known issues around setting
     * allowances. See {IERC20-approve}.
     */
    contract ERC20 is Context, IERC20, IERC20Metadata {
        mapping(address => uint256) private _balances;
        mapping(address => mapping(address => uint256)) private _allowances;
        uint256 private _totalSupply;
        string private _name;
        string private _symbol;
        /**
         * @dev Sets the values for {name} and {symbol}.
         *
         * The default value of {decimals} is 18. To select a different value for
         * {decimals} you should overload it.
         *
         * All two of these values are immutable: they can only be set once during
         * construction.
         */
        constructor(string memory name_, string memory symbol_) {
            _name = name_;
            _symbol = symbol_;
        }
        /**
         * @dev Returns the name of the token.
         */
        function name() public view virtual override returns (string memory) {
            return _name;
        }
        /**
         * @dev Returns the symbol of the token, usually a shorter version of the
         * name.
         */
        function symbol() public view virtual override returns (string memory) {
            return _symbol;
        }
        /**
         * @dev Returns the number of decimals used to get its user representation.
         * For example, if `decimals` equals `2`, a balance of `505` tokens should
         * be displayed to a user as `5.05` (`505 / 10 ** 2`).
         *
         * Tokens usually opt for a value of 18, imitating the relationship between
         * Ether and Wei. This is the value {ERC20} uses, unless this function is
         * overridden;
         *
         * NOTE: This information is only used for _display_ purposes: it in
         * no way affects any of the arithmetic of the contract, including
         * {IERC20-balanceOf} and {IERC20-transfer}.
         */
        function decimals() public view virtual override returns (uint8) {
            return 18;
        }
        /**
         * @dev See {IERC20-totalSupply}.
         */
        function totalSupply() public view virtual override returns (uint256) {
            return _totalSupply;
        }
        /**
         * @dev See {IERC20-balanceOf}.
         */
        function balanceOf(address account) public view virtual override returns (uint256) {
            return _balances[account];
        }
        /**
         * @dev See {IERC20-transfer}.
         *
         * Requirements:
         *
         * - `to` cannot be the zero address.
         * - the caller must have a balance of at least `amount`.
         */
        function transfer(address to, uint256 amount) public virtual override returns (bool) {
            address owner = _msgSender();
            _transfer(owner, to, amount);
            return true;
        }
        /**
         * @dev See {IERC20-allowance}.
         */
        function allowance(address owner, address spender) public view virtual override returns (uint256) {
            return _allowances[owner][spender];
        }
        /**
         * @dev See {IERC20-approve}.
         *
         * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
         * `transferFrom`. This is semantically equivalent to an infinite approval.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function approve(address spender, uint256 amount) public virtual override returns (bool) {
            address owner = _msgSender();
            _approve(owner, spender, amount);
            return true;
        }
        /**
         * @dev See {IERC20-transferFrom}.
         *
         * Emits an {Approval} event indicating the updated allowance. This is not
         * required by the EIP. See the note at the beginning of {ERC20}.
         *
         * NOTE: Does not update the allowance if the current allowance
         * is the maximum `uint256`.
         *
         * Requirements:
         *
         * - `from` and `to` cannot be the zero address.
         * - `from` must have a balance of at least `amount`.
         * - the caller must have allowance for ``from``'s tokens of at least
         * `amount`.
         */
        function transferFrom(
            address from,
            address to,
            uint256 amount
        ) public virtual override returns (bool) {
            address spender = _msgSender();
            _spendAllowance(from, spender, amount);
            _transfer(from, to, amount);
            return true;
        }
        /**
         * @dev Atomically increases the allowance granted to `spender` by the caller.
         *
         * This is an alternative to {approve} that can be used as a mitigation for
         * problems described in {IERC20-approve}.
         *
         * Emits an {Approval} event indicating the updated allowance.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         */
        function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
            address owner = _msgSender();
            _approve(owner, spender, allowance(owner, spender) + addedValue);
            return true;
        }
        /**
         * @dev Atomically decreases the allowance granted to `spender` by the caller.
         *
         * This is an alternative to {approve} that can be used as a mitigation for
         * problems described in {IERC20-approve}.
         *
         * Emits an {Approval} event indicating the updated allowance.
         *
         * Requirements:
         *
         * - `spender` cannot be the zero address.
         * - `spender` must have allowance for the caller of at least
         * `subtractedValue`.
         */
        function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
            address owner = _msgSender();
            uint256 currentAllowance = allowance(owner, spender);
            require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
            unchecked {
                _approve(owner, spender, currentAllowance - subtractedValue);
            }
            return true;
        }
        /**
         * @dev Moves `amount` of tokens from `from` to `to`.
         *
         * This internal function is equivalent to {transfer}, and can be used to
         * e.g. implement automatic token fees, slashing mechanisms, etc.
         *
         * Emits a {Transfer} event.
         *
         * Requirements:
         *
         * - `from` cannot be the zero address.
         * - `to` cannot be the zero address.
         * - `from` must have a balance of at least `amount`.
         */
        function _transfer(
            address from,
            address to,
            uint256 amount
        ) internal virtual {
            require(from != address(0), "ERC20: transfer from the zero address");
            require(to != address(0), "ERC20: transfer to the zero address");
            _beforeTokenTransfer(from, to, amount);
            uint256 fromBalance = _balances[from];
            require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
            unchecked {
                _balances[from] = fromBalance - amount;
                // Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
                // decrementing then incrementing.
                _balances[to] += amount;
            }
            emit Transfer(from, to, amount);
            _afterTokenTransfer(from, to, amount);
        }
        /** @dev Creates `amount` tokens and assigns them to `account`, increasing
         * the total supply.
         *
         * Emits a {Transfer} event with `from` set to the zero address.
         *
         * Requirements:
         *
         * - `account` cannot be the zero address.
         */
        function _mint(address account, uint256 amount) internal virtual {
            require(account != address(0), "ERC20: mint to the zero address");
            _beforeTokenTransfer(address(0), account, amount);
            _totalSupply += amount;
            unchecked {
                // Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
                _balances[account] += amount;
            }
            emit Transfer(address(0), account, amount);
            _afterTokenTransfer(address(0), account, amount);
        }
        /**
         * @dev Destroys `amount` tokens from `account`, reducing the
         * total supply.
         *
         * Emits a {Transfer} event with `to` set to the zero address.
         *
         * Requirements:
         *
         * - `account` cannot be the zero address.
         * - `account` must have at least `amount` tokens.
         */
        function _burn(address account, uint256 amount) internal virtual {
            require(account != address(0), "ERC20: burn from the zero address");
            _beforeTokenTransfer(account, address(0), amount);
            uint256 accountBalance = _balances[account];
            require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
            unchecked {
                _balances[account] = accountBalance - amount;
                // Overflow not possible: amount <= accountBalance <= totalSupply.
                _totalSupply -= amount;
            }
            emit Transfer(account, address(0), amount);
            _afterTokenTransfer(account, address(0), amount);
        }
        /**
         * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
         *
         * This internal function is equivalent to `approve`, and can be used to
         * e.g. set automatic allowances for certain subsystems, etc.
         *
         * Emits an {Approval} event.
         *
         * Requirements:
         *
         * - `owner` cannot be the zero address.
         * - `spender` cannot be the zero address.
         */
        function _approve(
            address owner,
            address spender,
            uint256 amount
        ) internal virtual {
            require(owner != address(0), "ERC20: approve from the zero address");
            require(spender != address(0), "ERC20: approve to the zero address");
            _allowances[owner][spender] = amount;
            emit Approval(owner, spender, amount);
        }
        /**
         * @dev Updates `owner` s allowance for `spender` based on spent `amount`.
         *
         * Does not update the allowance amount in case of infinite allowance.
         * Revert if not enough allowance is available.
         *
         * Might emit an {Approval} event.
         */
        function _spendAllowance(
            address owner,
            address spender,
            uint256 amount
        ) internal virtual {
            uint256 currentAllowance = allowance(owner, spender);
            if (currentAllowance != type(uint256).max) {
                require(currentAllowance >= amount, "ERC20: insufficient allowance");
                unchecked {
                    _approve(owner, spender, currentAllowance - amount);
                }
            }
        }
        /**
         * @dev Hook that is called before any transfer of tokens. This includes
         * minting and burning.
         *
         * Calling conditions:
         *
         * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
         * will be transferred to `to`.
         * - when `from` is zero, `amount` tokens will be minted for `to`.
         * - when `to` is zero, `amount` of ``from``'s tokens will be burned.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _beforeTokenTransfer(
            address from,
            address to,
            uint256 amount
        ) internal virtual {}
        /**
         * @dev Hook that is called after any transfer of tokens. This includes
         * minting and burning.
         *
         * Calling conditions:
         *
         * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
         * has been transferred to `to`.
         * - when `from` is zero, `amount` tokens have been minted for `to`.
         * - when `to` is zero, `amount` of ``from``'s tokens have been burned.
         * - `from` and `to` are never both zero.
         *
         * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
         */
        function _afterTokenTransfer(
            address from,
            address to,
            uint256 amount
        ) internal virtual {}
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev Interface of the ERC20 standard as defined in the EIP.
     */
    interface IERC20 {
        /**
         * @dev Emitted when `value` tokens are moved from one account (`from`) to
         * another (`to`).
         *
         * Note that `value` may be zero.
         */
        event Transfer(address indexed from, address indexed to, uint256 value);
        /**
         * @dev Emitted when the allowance of a `spender` for an `owner` is set by
         * a call to {approve}. `value` is the new allowance.
         */
        event Approval(address indexed owner, address indexed spender, uint256 value);
        /**
         * @dev Returns the amount of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the amount of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves `amount` tokens from the caller's account to `to`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address to, uint256 amount) external returns (bool);
        /**
         * @dev Returns the remaining number of tokens that `spender` will be
         * allowed to spend on behalf of `owner` through {transferFrom}. This is
         * zero by default.
         *
         * This value changes when {approve} or {transferFrom} are called.
         */
        function allowance(address owner, address spender) external view returns (uint256);
        /**
         * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * IMPORTANT: Beware that changing an allowance with this method brings the risk
         * that someone may use both the old and the new allowance by unfortunate
         * transaction ordering. One possible solution to mitigate this race
         * condition is to first reduce the spender's allowance to 0 and set the
         * desired value afterwards:
         * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
         *
         * Emits an {Approval} event.
         */
        function approve(address spender, uint256 amount) external returns (bool);
        /**
         * @dev Moves `amount` tokens from `from` to `to` using the
         * allowance mechanism. `amount` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(
            address from,
            address to,
            uint256 amount
        ) external returns (bool);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
    pragma solidity ^0.8.0;
    import "IERC20.sol";
    /**
     * @dev Interface for the optional metadata functions from the ERC20 standard.
     *
     * _Available since v4.1._
     */
    interface IERC20Metadata is IERC20 {
        /**
         * @dev Returns the name of the token.
         */
        function name() external view returns (string memory);
        /**
         * @dev Returns the symbol of the token.
         */
        function symbol() external view returns (string memory);
        /**
         * @dev Returns the decimals places of the token.
         */
        function decimals() external view returns (uint8);
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev Provides information about the current execution context, including the
     * sender of the transaction and its data. While these are generally available
     * via msg.sender and msg.data, they should not be accessed in such a direct
     * manner, since when dealing with meta-transactions the account sending and
     * paying for execution may not be the actual sender (as far as an application
     * is concerned).
     *
     * This contract is only required for intermediate, library-like contracts.
     */
    abstract contract Context {
        function _msgSender() internal view virtual returns (address) {
            return msg.sender;
        }
        function _msgData() internal view virtual returns (bytes calldata) {
            return msg.data;
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev Interface of the ERC165 standard, as defined in the
     * https://eips.ethereum.org/EIPS/eip-165[EIP].
     *
     * Implementers can declare support of contract interfaces, which can then be
     * queried by others ({ERC165Checker}).
     *
     * For an implementation, see {ERC165}.
     */
    interface IERC165 {
        /**
         * @dev Returns true if this contract implements the interface defined by
         * `interfaceId`. See the corresponding
         * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
         * to learn more about how these ids are created.
         *
         * This function call must use less than 30 000 gas.
         */
        function supportsInterface(bytes4 interfaceId) external view returns (bool);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.5.0;
    import "IOFTCore.sol";
    import "IERC20.sol";
    /**
     * @dev Interface of the OFT standard
     */
    interface IOFT is IOFTCore, IERC20 {
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.5.0;
    import "IERC165.sol";
    /**
     * @dev Interface of the IOFT core standard
     */
    interface IOFTCore is IERC165 {
        /**
         * @dev estimate send token `_tokenId` to (`_dstChainId`, `_toAddress`)
         * _dstChainId - L0 defined chain id to send tokens too
         * _toAddress - dynamic bytes array which contains the address to whom you are sending tokens to on the dstChain
         * _amount - amount of the tokens to transfer
         * _useZro - indicates to use zro to pay L0 fees
         * _adapterParam - flexible bytes array to indicate messaging adapter services in L0
         */
        function estimateSendFee(uint16 _dstChainId, bytes calldata _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) external view returns (uint nativeFee, uint zroFee);
        /**
         * @dev send `_amount` amount of token to (`_dstChainId`, `_toAddress`) from `_from`
         * `_from` the owner of token
         * `_dstChainId` the destination chain identifier
         * `_toAddress` can be any size depending on the `dstChainId`.
         * `_amount` the quantity of tokens in wei
         * `_refundAddress` the address LayerZero refunds if too much message fee is sent
         * `_zroPaymentAddress` set to address(0x0) if not paying in ZRO (LayerZero Token)
         * `_adapterParams` is a flexible bytes array to indicate messaging adapter services
         */
        function sendFrom(address _from, uint16 _dstChainId, bytes calldata _toAddress, uint _amount, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;
        /**
         * @dev returns the circulating amount of tokens on current chain
         */
        function circulatingSupply() external view returns (uint);
        /**
         * @dev returns the address of the ERC20 token
         */
        function token() external view returns (address);
        /**
         * @dev Emitted when `_amount` tokens are moved from the `_sender` to (`_dstChainId`, `_toAddress`)
         * `_nonce` is the outbound nonce
         */
        event SendToChain(uint16 indexed _dstChainId, address indexed _from, bytes _toAddress, uint _amount);
        /**
         * @dev Emitted when `_amount` tokens are received from `_srcChainId` into the `_toAddress` on the local chain.
         * `_nonce` is the inbound nonce.
         */
        event ReceiveFromChain(uint16 indexed _srcChainId, address indexed _to, uint _amount);
        event SetUseCustomAdapterParams(bool _useCustomAdapterParams);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    import "NonblockingLzApp.sol";
    import "IOFTCore.sol";
    import "ERC165.sol";
    abstract contract OFTCore is NonblockingLzApp, ERC165, IOFTCore {
        using BytesLib for bytes;
        uint public constant NO_EXTRA_GAS = 0;
        // packet type
        uint16 public constant PT_SEND = 0;
        bool public useCustomAdapterParams;
        constructor(address _lzEndpoint) NonblockingLzApp(_lzEndpoint) {}
        function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
            return interfaceId == type(IOFTCore).interfaceId || super.supportsInterface(interfaceId);
        }
        function estimateSendFee(uint16 _dstChainId, bytes calldata _toAddress, uint _amount, bool _useZro, bytes calldata _adapterParams) public view virtual override returns (uint nativeFee, uint zroFee) {
            // mock the payload for sendFrom()
            bytes memory payload = abi.encode(PT_SEND, _toAddress, _amount);
            return lzEndpoint.estimateFees(_dstChainId, address(this), payload, _useZro, _adapterParams);
        }
        function sendFrom(address _from, uint16 _dstChainId, bytes calldata _toAddress, uint _amount, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) public payable virtual override {
            _send(_from, _dstChainId, _toAddress, _amount, _refundAddress, _zroPaymentAddress, _adapterParams);
        }
        function setUseCustomAdapterParams(bool _useCustomAdapterParams) public virtual onlyOwner {
            useCustomAdapterParams = _useCustomAdapterParams;
            emit SetUseCustomAdapterParams(_useCustomAdapterParams);
        }
        function _nonblockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual override {
            uint16 packetType;
            assembly {
                packetType := mload(add(_payload, 32))
            }
            if (packetType == PT_SEND) {
                _sendAck(_srcChainId, _srcAddress, _nonce, _payload);
            } else {
                revert("OFTCore: unknown packet type");
            }
        }
        function _send(address _from, uint16 _dstChainId, bytes memory _toAddress, uint _amount, address payable _refundAddress, address _zroPaymentAddress, bytes memory _adapterParams) internal virtual {
            _checkAdapterParams(_dstChainId, PT_SEND, _adapterParams, NO_EXTRA_GAS);
            uint amount = _debitFrom(_from, _dstChainId, _toAddress, _amount);
            bytes memory lzPayload = abi.encode(PT_SEND, _toAddress, amount);
            _lzSend(_dstChainId, lzPayload, _refundAddress, _zroPaymentAddress, _adapterParams, msg.value);
            emit SendToChain(_dstChainId, _from, _toAddress, amount);
        }
        function _sendAck(uint16 _srcChainId, bytes memory, uint64, bytes memory _payload) internal virtual {
            (, bytes memory toAddressBytes, uint amount) = abi.decode(_payload, (uint16, bytes, uint));
            address to = toAddressBytes.toAddress(0);
            amount = _creditTo(_srcChainId, to, amount);
            emit ReceiveFromChain(_srcChainId, to, amount);
        }
        function _checkAdapterParams(uint16 _dstChainId, uint16 _pkType, bytes memory _adapterParams, uint _extraGas) internal virtual {
            if (useCustomAdapterParams) {
                _checkGasLimit(_dstChainId, _pkType, _adapterParams, _extraGas);
            } else {
                require(_adapterParams.length == 0, "OFTCore: _adapterParams must be empty.");
            }
        }
        function _debitFrom(address _from, uint16 _dstChainId, bytes memory _toAddress, uint _amount) internal virtual returns(uint);
        function _creditTo(uint16 _srcChainId, address _toAddress, uint _amount) internal virtual returns(uint);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    import "LzApp.sol";
    import "ExcessivelySafeCall.sol";
    /*
     * the default LayerZero messaging behaviour is blocking, i.e. any failed message will block the channel
     * this abstract class try-catch all fail messages and store locally for future retry. hence, non-blocking
     * NOTE: if the srcAddress is not configured properly, it will still block the message pathway from (srcChainId, srcAddress)
     */
    abstract contract NonblockingLzApp is LzApp {
        using ExcessivelySafeCall for address;
        constructor(address _endpoint) LzApp(_endpoint) {}
        mapping(uint16 => mapping(bytes => mapping(uint64 => bytes32))) public failedMessages;
        event MessageFailed(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes _payload, bytes _reason);
        event RetryMessageSuccess(uint16 _srcChainId, bytes _srcAddress, uint64 _nonce, bytes32 _payloadHash);
        // overriding the virtual function in LzReceiver
        function _blockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual override {
            (bool success, bytes memory reason) = address(this).excessivelySafeCall(gasleft(), 150, abi.encodeWithSelector(this.nonblockingLzReceive.selector, _srcChainId, _srcAddress, _nonce, _payload));
            // try-catch all errors/exceptions
            if (!success) {
                _storeFailedMessage(_srcChainId, _srcAddress, _nonce, _payload, reason);
            }
        }
        function _storeFailedMessage(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload, bytes memory _reason) internal virtual {
            failedMessages[_srcChainId][_srcAddress][_nonce] = keccak256(_payload);
            emit MessageFailed(_srcChainId, _srcAddress, _nonce, _payload, _reason);
        }
        function nonblockingLzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) public virtual {
            // only internal transaction
            require(_msgSender() == address(this), "NonblockingLzApp: caller must be LzApp");
            _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);
        }
        //@notice override this function
        function _nonblockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual;
        function retryMessage(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) public payable virtual {
            // assert there is message to retry
            bytes32 payloadHash = failedMessages[_srcChainId][_srcAddress][_nonce];
            require(payloadHash != bytes32(0), "NonblockingLzApp: no stored message");
            require(keccak256(_payload) == payloadHash, "NonblockingLzApp: invalid payload");
            // clear the stored message
            failedMessages[_srcChainId][_srcAddress][_nonce] = bytes32(0);
            // execute the message. revert if it fails again
            _nonblockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);
            emit RetryMessageSuccess(_srcChainId, _srcAddress, _nonce, payloadHash);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    import "Ownable.sol";
    import "ILayerZeroReceiver.sol";
    import "ILayerZeroUserApplicationConfig.sol";
    import "ILayerZeroEndpoint.sol";
    import "BytesLib.sol";
    /*
     * a generic LzReceiver implementation
     */
    abstract contract LzApp is Ownable, ILayerZeroReceiver, ILayerZeroUserApplicationConfig {
        using BytesLib for bytes;
        // ua can not send payload larger than this by default, but it can be changed by the ua owner
        uint constant public DEFAULT_PAYLOAD_SIZE_LIMIT = 10000;
        ILayerZeroEndpoint public immutable lzEndpoint;
        mapping(uint16 => bytes) public trustedRemoteLookup;
        mapping(uint16 => mapping(uint16 => uint)) public minDstGasLookup;
        mapping(uint16 => uint) public payloadSizeLimitLookup;
        address public precrime;
        event SetPrecrime(address precrime);
        event SetTrustedRemote(uint16 _remoteChainId, bytes _path);
        event SetTrustedRemoteAddress(uint16 _remoteChainId, bytes _remoteAddress);
        event SetMinDstGas(uint16 _dstChainId, uint16 _type, uint _minDstGas);
        constructor(address _endpoint) {
            lzEndpoint = ILayerZeroEndpoint(_endpoint);
        }
        function lzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) public virtual override {
            // lzReceive must be called by the endpoint for security
            require(_msgSender() == address(lzEndpoint), "LzApp: invalid endpoint caller");
            bytes memory trustedRemote = trustedRemoteLookup[_srcChainId];
            // if will still block the message pathway from (srcChainId, srcAddress). should not receive message from untrusted remote.
            require(_srcAddress.length == trustedRemote.length && trustedRemote.length > 0 && keccak256(_srcAddress) == keccak256(trustedRemote), "LzApp: invalid source sending contract");
            _blockingLzReceive(_srcChainId, _srcAddress, _nonce, _payload);
        }
        // abstract function - the default behaviour of LayerZero is blocking. See: NonblockingLzApp if you dont need to enforce ordered messaging
        function _blockingLzReceive(uint16 _srcChainId, bytes memory _srcAddress, uint64 _nonce, bytes memory _payload) internal virtual;
        function _lzSend(uint16 _dstChainId, bytes memory _payload, address payable _refundAddress, address _zroPaymentAddress, bytes memory _adapterParams, uint _nativeFee) internal virtual {
            bytes memory trustedRemote = trustedRemoteLookup[_dstChainId];
            require(trustedRemote.length != 0, "LzApp: destination chain is not a trusted source");
            _checkPayloadSize(_dstChainId, _payload.length);
            lzEndpoint.send{value: _nativeFee}(_dstChainId, trustedRemote, _payload, _refundAddress, _zroPaymentAddress, _adapterParams);
        }
        function _checkGasLimit(uint16 _dstChainId, uint16 _type, bytes memory _adapterParams, uint _extraGas) internal view virtual {
            uint providedGasLimit = _getGasLimit(_adapterParams);
            uint minGasLimit = minDstGasLookup[_dstChainId][_type] + _extraGas;
            require(minGasLimit > 0, "LzApp: minGasLimit not set");
            require(providedGasLimit >= minGasLimit, "LzApp: gas limit is too low");
        }
        function _getGasLimit(bytes memory _adapterParams) internal pure virtual returns (uint gasLimit) {
            require(_adapterParams.length >= 34, "LzApp: invalid adapterParams");
            assembly {
                gasLimit := mload(add(_adapterParams, 34))
            }
        }
        function _checkPayloadSize(uint16 _dstChainId, uint _payloadSize) internal view virtual {
            uint payloadSizeLimit = payloadSizeLimitLookup[_dstChainId];
            if (payloadSizeLimit == 0) { // use default if not set
                payloadSizeLimit = DEFAULT_PAYLOAD_SIZE_LIMIT;
            }
            require(_payloadSize <= payloadSizeLimit, "LzApp: payload size is too large");
        }
        //---------------------------UserApplication config----------------------------------------
        function getConfig(uint16 _version, uint16 _chainId, address, uint _configType) external view returns (bytes memory) {
            return lzEndpoint.getConfig(_version, _chainId, address(this), _configType);
        }
        // generic config for LayerZero user Application
        function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external override onlyOwner {
            lzEndpoint.setConfig(_version, _chainId, _configType, _config);
        }
        function setSendVersion(uint16 _version) external override onlyOwner {
            lzEndpoint.setSendVersion(_version);
        }
        function setReceiveVersion(uint16 _version) external override onlyOwner {
            lzEndpoint.setReceiveVersion(_version);
        }
        function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external override onlyOwner {
            lzEndpoint.forceResumeReceive(_srcChainId, _srcAddress);
        }
        // _path = abi.encodePacked(remoteAddress, localAddress)
        // this function set the trusted path for the cross-chain communication
        function setTrustedRemote(uint16 _srcChainId, bytes calldata _path) external onlyOwner {
            trustedRemoteLookup[_srcChainId] = _path;
            emit SetTrustedRemote(_srcChainId, _path);
        }
        function setTrustedRemoteAddress(uint16 _remoteChainId, bytes calldata _remoteAddress) external onlyOwner {
            trustedRemoteLookup[_remoteChainId] = abi.encodePacked(_remoteAddress, address(this));
            emit SetTrustedRemoteAddress(_remoteChainId, _remoteAddress);
        }
        function getTrustedRemoteAddress(uint16 _remoteChainId) external view returns (bytes memory) {
            bytes memory path = trustedRemoteLookup[_remoteChainId];
            require(path.length != 0, "LzApp: no trusted path record");
            return path.slice(0, path.length - 20); // the last 20 bytes should be address(this)
        }
        function setPrecrime(address _precrime) external onlyOwner {
            precrime = _precrime;
            emit SetPrecrime(_precrime);
        }
        function setMinDstGas(uint16 _dstChainId, uint16 _packetType, uint _minGas) external onlyOwner {
            require(_minGas > 0, "LzApp: invalid minGas");
            minDstGasLookup[_dstChainId][_packetType] = _minGas;
            emit SetMinDstGas(_dstChainId, _packetType, _minGas);
        }
        // if the size is 0, it means default size limit
        function setPayloadSizeLimit(uint16 _dstChainId, uint _size) external onlyOwner {
            payloadSizeLimitLookup[_dstChainId] = _size;
        }
        //--------------------------- VIEW FUNCTION ----------------------------------------
        function isTrustedRemote(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool) {
            bytes memory trustedSource = trustedRemoteLookup[_srcChainId];
            return keccak256(trustedSource) == keccak256(_srcAddress);
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
    pragma solidity ^0.8.0;
    import "Context.sol";
    /**
     * @dev Contract module which provides a basic access control mechanism, where
     * there is an account (an owner) that can be granted exclusive access to
     * specific functions.
     *
     * By default, the owner account will be the one that deploys the contract. This
     * can later be changed with {transferOwnership}.
     *
     * This module is used through inheritance. It will make available the modifier
     * `onlyOwner`, which can be applied to your functions to restrict their use to
     * the owner.
     */
    abstract contract Ownable is Context {
        address private _owner;
        event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
        /**
         * @dev Initializes the contract setting the deployer as the initial owner.
         */
        constructor() {
            _transferOwnership(_msgSender());
        }
        /**
         * @dev Throws if called by any account other than the owner.
         */
        modifier onlyOwner() {
            _checkOwner();
            _;
        }
        /**
         * @dev Returns the address of the current owner.
         */
        function owner() public view virtual returns (address) {
            return _owner;
        }
        /**
         * @dev Throws if the sender is not the owner.
         */
        function _checkOwner() internal view virtual {
            require(owner() == _msgSender(), "Ownable: caller is not the owner");
        }
        /**
         * @dev Leaves the contract without owner. It will not be possible to call
         * `onlyOwner` functions anymore. Can only be called by the current owner.
         *
         * NOTE: Renouncing ownership will leave the contract without an owner,
         * thereby removing any functionality that is only available to the owner.
         */
        function renounceOwnership() public virtual onlyOwner {
            _transferOwnership(address(0));
        }
        /**
         * @dev Transfers ownership of the contract to a new account (`newOwner`).
         * Can only be called by the current owner.
         */
        function transferOwnership(address newOwner) public virtual onlyOwner {
            require(newOwner != address(0), "Ownable: new owner is the zero address");
            _transferOwnership(newOwner);
        }
        /**
         * @dev Transfers ownership of the contract to a new account (`newOwner`).
         * Internal function without access restriction.
         */
        function _transferOwnership(address newOwner) internal virtual {
            address oldOwner = _owner;
            _owner = newOwner;
            emit OwnershipTransferred(oldOwner, newOwner);
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.5.0;
    interface ILayerZeroReceiver {
        // @notice LayerZero endpoint will invoke this function to deliver the message on the destination
        // @param _srcChainId - the source endpoint identifier
        // @param _srcAddress - the source sending contract address from the source chain
        // @param _nonce - the ordered message nonce
        // @param _payload - the signed payload is the UA bytes has encoded to be sent
        function lzReceive(uint16 _srcChainId, bytes calldata _srcAddress, uint64 _nonce, bytes calldata _payload) external;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.5.0;
    interface ILayerZeroUserApplicationConfig {
        // @notice set the configuration of the LayerZero messaging library of the specified version
        // @param _version - messaging library version
        // @param _chainId - the chainId for the pending config change
        // @param _configType - type of configuration. every messaging library has its own convention.
        // @param _config - configuration in the bytes. can encode arbitrary content.
        function setConfig(uint16 _version, uint16 _chainId, uint _configType, bytes calldata _config) external;
        // @notice set the send() LayerZero messaging library version to _version
        // @param _version - new messaging library version
        function setSendVersion(uint16 _version) external;
        // @notice set the lzReceive() LayerZero messaging library version to _version
        // @param _version - new messaging library version
        function setReceiveVersion(uint16 _version) external;
        // @notice Only when the UA needs to resume the message flow in blocking mode and clear the stored payload
        // @param _srcChainId - the chainId of the source chain
        // @param _srcAddress - the contract address of the source contract at the source chain
        function forceResumeReceive(uint16 _srcChainId, bytes calldata _srcAddress) external;
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.5.0;
    import "ILayerZeroUserApplicationConfig.sol";
    interface ILayerZeroEndpoint is ILayerZeroUserApplicationConfig {
        // @notice send a LayerZero message to the specified address at a LayerZero endpoint.
        // @param _dstChainId - the destination chain identifier
        // @param _destination - the address on destination chain (in bytes). address length/format may vary by chains
        // @param _payload - a custom bytes payload to send to the destination contract
        // @param _refundAddress - if the source transaction is cheaper than the amount of value passed, refund the additional amount to this address
        // @param _zroPaymentAddress - the address of the ZRO token holder who would pay for the transaction
        // @param _adapterParams - parameters for custom functionality. e.g. receive airdropped native gas from the relayer on destination
        function send(uint16 _dstChainId, bytes calldata _destination, bytes calldata _payload, address payable _refundAddress, address _zroPaymentAddress, bytes calldata _adapterParams) external payable;
        // @notice used by the messaging library to publish verified payload
        // @param _srcChainId - the source chain identifier
        // @param _srcAddress - the source contract (as bytes) at the source chain
        // @param _dstAddress - the address on destination chain
        // @param _nonce - the unbound message ordering nonce
        // @param _gasLimit - the gas limit for external contract execution
        // @param _payload - verified payload to send to the destination contract
        function receivePayload(uint16 _srcChainId, bytes calldata _srcAddress, address _dstAddress, uint64 _nonce, uint _gasLimit, bytes calldata _payload) external;
        // @notice get the inboundNonce of a lzApp from a source chain which could be EVM or non-EVM chain
        // @param _srcChainId - the source chain identifier
        // @param _srcAddress - the source chain contract address
        function getInboundNonce(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (uint64);
        // @notice get the outboundNonce from this source chain which, consequently, is always an EVM
        // @param _srcAddress - the source chain contract address
        function getOutboundNonce(uint16 _dstChainId, address _srcAddress) external view returns (uint64);
        // @notice gets a quote in source native gas, for the amount that send() requires to pay for message delivery
        // @param _dstChainId - the destination chain identifier
        // @param _userApplication - the user app address on this EVM chain
        // @param _payload - the custom message to send over LayerZero
        // @param _payInZRO - if false, user app pays the protocol fee in native token
        // @param _adapterParam - parameters for the adapter service, e.g. send some dust native token to dstChain
        function estimateFees(uint16 _dstChainId, address _userApplication, bytes calldata _payload, bool _payInZRO, bytes calldata _adapterParam) external view returns (uint nativeFee, uint zroFee);
        // @notice get this Endpoint's immutable source identifier
        function getChainId() external view returns (uint16);
        // @notice the interface to retry failed message on this Endpoint destination
        // @param _srcChainId - the source chain identifier
        // @param _srcAddress - the source chain contract address
        // @param _payload - the payload to be retried
        function retryPayload(uint16 _srcChainId, bytes calldata _srcAddress, bytes calldata _payload) external;
        // @notice query if any STORED payload (message blocking) at the endpoint.
        // @param _srcChainId - the source chain identifier
        // @param _srcAddress - the source chain contract address
        function hasStoredPayload(uint16 _srcChainId, bytes calldata _srcAddress) external view returns (bool);
        // @notice query if the _libraryAddress is valid for sending msgs.
        // @param _userApplication - the user app address on this EVM chain
        function getSendLibraryAddress(address _userApplication) external view returns (address);
        // @notice query if the _libraryAddress is valid for receiving msgs.
        // @param _userApplication - the user app address on this EVM chain
        function getReceiveLibraryAddress(address _userApplication) external view returns (address);
        // @notice query if the non-reentrancy guard for send() is on
        // @return true if the guard is on. false otherwise
        function isSendingPayload() external view returns (bool);
        // @notice query if the non-reentrancy guard for receive() is on
        // @return true if the guard is on. false otherwise
        function isReceivingPayload() external view returns (bool);
        // @notice get the configuration of the LayerZero messaging library of the specified version
        // @param _version - messaging library version
        // @param _chainId - the chainId for the pending config change
        // @param _userApplication - the contract address of the user application
        // @param _configType - type of configuration. every messaging library has its own convention.
        function getConfig(uint16 _version, uint16 _chainId, address _userApplication, uint _configType) external view returns (bytes memory);
        // @notice get the send() LayerZero messaging library version
        // @param _userApplication - the contract address of the user application
        function getSendVersion(address _userApplication) external view returns (uint16);
        // @notice get the lzReceive() LayerZero messaging library version
        // @param _userApplication - the contract address of the user application
        function getReceiveVersion(address _userApplication) external view returns (uint16);
    }
    // SPDX-License-Identifier: Unlicense
    /*
     * @title Solidity Bytes Arrays Utils
     * @author Gonçalo Sá <[email protected]>
     *
     * @dev Bytes tightly packed arrays utility library for ethereum contracts written in Solidity.
     *      The library lets you concatenate, slice and type cast bytes arrays both in memory and storage.
     */
    pragma solidity >=0.8.0 <0.9.0;
    library BytesLib {
        function concat(
            bytes memory _preBytes,
            bytes memory _postBytes
        )
        internal
        pure
        returns (bytes memory)
        {
            bytes memory tempBytes;
            assembly {
            // Get a location of some free memory and store it in tempBytes as
            // Solidity does for memory variables.
                tempBytes := mload(0x40)
            // Store the length of the first bytes array at the beginning of
            // the memory for tempBytes.
                let length := mload(_preBytes)
                mstore(tempBytes, length)
            // Maintain a memory counter for the current write location in the
            // temp bytes array by adding the 32 bytes for the array length to
            // the starting location.
                let mc := add(tempBytes, 0x20)
            // Stop copying when the memory counter reaches the length of the
            // first bytes array.
                let end := add(mc, length)
                for {
                // Initialize a copy counter to the start of the _preBytes data,
                // 32 bytes into its memory.
                    let cc := add(_preBytes, 0x20)
                } lt(mc, end) {
                // Increase both counters by 32 bytes each iteration.
                    mc := add(mc, 0x20)
                    cc := add(cc, 0x20)
                } {
                // Write the _preBytes data into the tempBytes memory 32 bytes
                // at a time.
                    mstore(mc, mload(cc))
                }
            // Add the length of _postBytes to the current length of tempBytes
            // and store it as the new length in the first 32 bytes of the
            // tempBytes memory.
                length := mload(_postBytes)
                mstore(tempBytes, add(length, mload(tempBytes)))
            // Move the memory counter back from a multiple of 0x20 to the
            // actual end of the _preBytes data.
                mc := end
            // Stop copying when the memory counter reaches the new combined
            // length of the arrays.
                end := add(mc, length)
                for {
                    let cc := add(_postBytes, 0x20)
                } lt(mc, end) {
                    mc := add(mc, 0x20)
                    cc := add(cc, 0x20)
                } {
                    mstore(mc, mload(cc))
                }
            // Update the free-memory pointer by padding our last write location
            // to 32 bytes: add 31 bytes to the end of tempBytes to move to the
            // next 32 byte block, then round down to the nearest multiple of
            // 32. If the sum of the length of the two arrays is zero then add
            // one before rounding down to leave a blank 32 bytes (the length block with 0).
                mstore(0x40, and(
                add(add(end, iszero(add(length, mload(_preBytes)))), 31),
                not(31) // Round down to the nearest 32 bytes.
                ))
            }
            return tempBytes;
        }
        function concatStorage(bytes storage _preBytes, bytes memory _postBytes) internal {
            assembly {
            // Read the first 32 bytes of _preBytes storage, which is the length
            // of the array. (We don't need to use the offset into the slot
            // because arrays use the entire slot.)
                let fslot := sload(_preBytes.slot)
            // Arrays of 31 bytes or less have an even value in their slot,
            // while longer arrays have an odd value. The actual length is
            // the slot divided by two for odd values, and the lowest order
            // byte divided by two for even values.
            // If the slot is even, bitwise and the slot with 255 and divide by
            // two to get the length. If the slot is odd, bitwise and the slot
            // with -1 and divide by two.
                let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)
                let mlength := mload(_postBytes)
                let newlength := add(slength, mlength)
            // slength can contain both the length and contents of the array
            // if length < 32 bytes so let's prepare for that
            // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage
                switch add(lt(slength, 32), lt(newlength, 32))
                case 2 {
                // Since the new array still fits in the slot, we just need to
                // update the contents of the slot.
                // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length
                    sstore(
                    _preBytes.slot,
                    // all the modifications to the slot are inside this
                    // next block
                    add(
                    // we can just add to the slot contents because the
                    // bytes we want to change are the LSBs
                    fslot,
                    add(
                    mul(
                    div(
                    // load the bytes from memory
                    mload(add(_postBytes, 0x20)),
                    // zero all bytes to the right
                    exp(0x100, sub(32, mlength))
                    ),
                    // and now shift left the number of bytes to
                    // leave space for the length in the slot
                    exp(0x100, sub(32, newlength))
                    ),
                    // increase length by the double of the memory
                    // bytes length
                    mul(mlength, 2)
                    )
                    )
                    )
                }
                case 1 {
                // The stored value fits in the slot, but the combined value
                // will exceed it.
                // get the keccak hash to get the contents of the array
                    mstore(0x0, _preBytes.slot)
                    let sc := add(keccak256(0x0, 0x20), div(slength, 32))
                // save new length
                    sstore(_preBytes.slot, add(mul(newlength, 2), 1))
                // The contents of the _postBytes array start 32 bytes into
                // the structure. Our first read should obtain the `submod`
                // bytes that can fit into the unused space in the last word
                // of the stored array. To get this, we read 32 bytes starting
                // from `submod`, so the data we read overlaps with the array
                // contents by `submod` bytes. Masking the lowest-order
                // `submod` bytes allows us to add that value directly to the
                // stored value.
                    let submod := sub(32, slength)
                    let mc := add(_postBytes, submod)
                    let end := add(_postBytes, mlength)
                    let mask := sub(exp(0x100, submod), 1)
                    sstore(
                    sc,
                    add(
                    and(
                    fslot,
                    0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00
                    ),
                    and(mload(mc), mask)
                    )
                    )
                    for {
                        mc := add(mc, 0x20)
                        sc := add(sc, 1)
                    } lt(mc, end) {
                        sc := add(sc, 1)
                        mc := add(mc, 0x20)
                    } {
                        sstore(sc, mload(mc))
                    }
                    mask := exp(0x100, sub(mc, end))
                    sstore(sc, mul(div(mload(mc), mask), mask))
                }
                default {
                // get the keccak hash to get the contents of the array
                    mstore(0x0, _preBytes.slot)
                // Start copying to the last used word of the stored array.
                    let sc := add(keccak256(0x0, 0x20), div(slength, 32))
                // save new length
                    sstore(_preBytes.slot, add(mul(newlength, 2), 1))
                // Copy over the first `submod` bytes of the new data as in
                // case 1 above.
                    let slengthmod := mod(slength, 32)
                    let mlengthmod := mod(mlength, 32)
                    let submod := sub(32, slengthmod)
                    let mc := add(_postBytes, submod)
                    let end := add(_postBytes, mlength)
                    let mask := sub(exp(0x100, submod), 1)
                    sstore(sc, add(sload(sc), and(mload(mc), mask)))
                    for {
                        sc := add(sc, 1)
                        mc := add(mc, 0x20)
                    } lt(mc, end) {
                        sc := add(sc, 1)
                        mc := add(mc, 0x20)
                    } {
                        sstore(sc, mload(mc))
                    }
                    mask := exp(0x100, sub(mc, end))
                    sstore(sc, mul(div(mload(mc), mask), mask))
                }
            }
        }
        function slice(
            bytes memory _bytes,
            uint256 _start,
            uint256 _length
        )
        internal
        pure
        returns (bytes memory)
        {
            require(_length + 31 >= _length, "slice_overflow");
            require(_bytes.length >= _start + _length, "slice_outOfBounds");
            bytes memory tempBytes;
            assembly {
                switch iszero(_length)
                case 0 {
                // Get a location of some free memory and store it in tempBytes as
                // Solidity does for memory variables.
                    tempBytes := mload(0x40)
                // The first word of the slice result is potentially a partial
                // word read from the original array. To read it, we calculate
                // the length of that partial word and start copying that many
                // bytes into the array. The first word we copy will start with
                // data we don't care about, but the last `lengthmod` bytes will
                // land at the beginning of the contents of the new array. When
                // we're done copying, we overwrite the full first word with
                // the actual length of the slice.
                    let lengthmod := and(_length, 31)
                // The multiplication in the next line is necessary
                // because when slicing multiples of 32 bytes (lengthmod == 0)
                // the following copy loop was copying the origin's length
                // and then ending prematurely not copying everything it should.
                    let mc := add(add(tempBytes, lengthmod), mul(0x20, iszero(lengthmod)))
                    let end := add(mc, _length)
                    for {
                    // The multiplication in the next line has the same exact purpose
                    // as the one above.
                        let cc := add(add(add(_bytes, lengthmod), mul(0x20, iszero(lengthmod))), _start)
                    } lt(mc, end) {
                        mc := add(mc, 0x20)
                        cc := add(cc, 0x20)
                    } {
                        mstore(mc, mload(cc))
                    }
                    mstore(tempBytes, _length)
                //update free-memory pointer
                //allocating the array padded to 32 bytes like the compiler does now
                    mstore(0x40, and(add(mc, 31), not(31)))
                }
                //if we want a zero-length slice let's just return a zero-length array
                default {
                    tempBytes := mload(0x40)
                //zero out the 32 bytes slice we are about to return
                //we need to do it because Solidity does not garbage collect
                    mstore(tempBytes, 0)
                    mstore(0x40, add(tempBytes, 0x20))
                }
            }
            return tempBytes;
        }
        function toAddress(bytes memory _bytes, uint256 _start) internal pure returns (address) {
            require(_bytes.length >= _start + 20, "toAddress_outOfBounds");
            address tempAddress;
            assembly {
                tempAddress := div(mload(add(add(_bytes, 0x20), _start)), 0x1000000000000000000000000)
            }
            return tempAddress;
        }
        function toUint8(bytes memory _bytes, uint256 _start) internal pure returns (uint8) {
            require(_bytes.length >= _start + 1 , "toUint8_outOfBounds");
            uint8 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x1), _start))
            }
            return tempUint;
        }
        function toUint16(bytes memory _bytes, uint256 _start) internal pure returns (uint16) {
            require(_bytes.length >= _start + 2, "toUint16_outOfBounds");
            uint16 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x2), _start))
            }
            return tempUint;
        }
        function toUint32(bytes memory _bytes, uint256 _start) internal pure returns (uint32) {
            require(_bytes.length >= _start + 4, "toUint32_outOfBounds");
            uint32 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x4), _start))
            }
            return tempUint;
        }
        function toUint64(bytes memory _bytes, uint256 _start) internal pure returns (uint64) {
            require(_bytes.length >= _start + 8, "toUint64_outOfBounds");
            uint64 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x8), _start))
            }
            return tempUint;
        }
        function toUint96(bytes memory _bytes, uint256 _start) internal pure returns (uint96) {
            require(_bytes.length >= _start + 12, "toUint96_outOfBounds");
            uint96 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0xc), _start))
            }
            return tempUint;
        }
        function toUint128(bytes memory _bytes, uint256 _start) internal pure returns (uint128) {
            require(_bytes.length >= _start + 16, "toUint128_outOfBounds");
            uint128 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x10), _start))
            }
            return tempUint;
        }
        function toUint256(bytes memory _bytes, uint256 _start) internal pure returns (uint256) {
            require(_bytes.length >= _start + 32, "toUint256_outOfBounds");
            uint256 tempUint;
            assembly {
                tempUint := mload(add(add(_bytes, 0x20), _start))
            }
            return tempUint;
        }
        function toBytes32(bytes memory _bytes, uint256 _start) internal pure returns (bytes32) {
            require(_bytes.length >= _start + 32, "toBytes32_outOfBounds");
            bytes32 tempBytes32;
            assembly {
                tempBytes32 := mload(add(add(_bytes, 0x20), _start))
            }
            return tempBytes32;
        }
        function equal(bytes memory _preBytes, bytes memory _postBytes) internal pure returns (bool) {
            bool success = true;
            assembly {
                let length := mload(_preBytes)
            // if lengths don't match the arrays are not equal
                switch eq(length, mload(_postBytes))
                case 1 {
                // cb is a circuit breaker in the for loop since there's
                //  no said feature for inline assembly loops
                // cb = 1 - don't breaker
                // cb = 0 - break
                    let cb := 1
                    let mc := add(_preBytes, 0x20)
                    let end := add(mc, length)
                    for {
                        let cc := add(_postBytes, 0x20)
                    // the next line is the loop condition:
                    // while(uint256(mc < end) + cb == 2)
                    } eq(add(lt(mc, end), cb), 2) {
                        mc := add(mc, 0x20)
                        cc := add(cc, 0x20)
                    } {
                    // if any of these checks fails then arrays are not equal
                        if iszero(eq(mload(mc), mload(cc))) {
                        // unsuccess:
                            success := 0
                            cb := 0
                        }
                    }
                }
                default {
                // unsuccess:
                    success := 0
                }
            }
            return success;
        }
        function equalStorage(
            bytes storage _preBytes,
            bytes memory _postBytes
        )
        internal
        view
        returns (bool)
        {
            bool success = true;
            assembly {
            // we know _preBytes_offset is 0
                let fslot := sload(_preBytes.slot)
            // Decode the length of the stored array like in concatStorage().
                let slength := div(and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)), 2)
                let mlength := mload(_postBytes)
            // if lengths don't match the arrays are not equal
                switch eq(slength, mlength)
                case 1 {
                // slength can contain both the length and contents of the array
                // if length < 32 bytes so let's prepare for that
                // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage
                    if iszero(iszero(slength)) {
                        switch lt(slength, 32)
                        case 1 {
                        // blank the last byte which is the length
                            fslot := mul(div(fslot, 0x100), 0x100)
                            if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {
                            // unsuccess:
                                success := 0
                            }
                        }
                        default {
                        // cb is a circuit breaker in the for loop since there's
                        //  no said feature for inline assembly loops
                        // cb = 1 - don't breaker
                        // cb = 0 - break
                            let cb := 1
                        // get the keccak hash to get the contents of the array
                            mstore(0x0, _preBytes.slot)
                            let sc := keccak256(0x0, 0x20)
                            let mc := add(_postBytes, 0x20)
                            let end := add(mc, mlength)
                        // the next line is the loop condition:
                        // while(uint256(mc < end) + cb == 2)
                            for {} eq(add(lt(mc, end), cb), 2) {
                                sc := add(sc, 1)
                                mc := add(mc, 0x20)
                            } {
                                if iszero(eq(sload(sc), mload(mc))) {
                                // unsuccess:
                                    success := 0
                                    cb := 0
                                }
                            }
                        }
                    }
                }
                default {
                // unsuccess:
                    success := 0
                }
            }
            return success;
        }
    }
    // SPDX-License-Identifier: MIT OR Apache-2.0
    pragma solidity >=0.7.6;
    library ExcessivelySafeCall {
        uint256 constant LOW_28_MASK =
        0x00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
        /// @notice Use when you _really_ really _really_ don't trust the called
        /// contract. This prevents the called contract from causing reversion of
        /// the caller in as many ways as we can.
        /// @dev The main difference between this and a solidity low-level call is
        /// that we limit the number of bytes that the callee can cause to be
        /// copied to caller memory. This prevents stupid things like malicious
        /// contracts returning 10,000,000 bytes causing a local OOG when copying
        /// to memory.
        /// @param _target The address to call
        /// @param _gas The amount of gas to forward to the remote contract
        /// @param _maxCopy The maximum number of bytes of returndata to copy
        /// to memory.
        /// @param _calldata The data to send to the remote contract
        /// @return success and returndata, as `.call()`. Returndata is capped to
        /// `_maxCopy` bytes.
        function excessivelySafeCall(
            address _target,
            uint256 _gas,
            uint16 _maxCopy,
            bytes memory _calldata
        ) internal returns (bool, bytes memory) {
            // set up for assembly call
            uint256 _toCopy;
            bool _success;
            bytes memory _returnData = new bytes(_maxCopy);
            // dispatch message to recipient
            // by assembly calling "handle" function
            // we call via assembly to avoid memcopying a very large returndata
            // returned by a malicious contract
            assembly {
                _success := call(
                _gas, // gas
                _target, // recipient
                0, // ether value
                add(_calldata, 0x20), // inloc
                mload(_calldata), // inlen
                0, // outloc
                0 // outlen
                )
            // limit our copy to 256 bytes
                _toCopy := returndatasize()
                if gt(_toCopy, _maxCopy) {
                    _toCopy := _maxCopy
                }
            // Store the length of the copied bytes
                mstore(_returnData, _toCopy)
            // copy the bytes from returndata[0:_toCopy]
                returndatacopy(add(_returnData, 0x20), 0, _toCopy)
            }
            return (_success, _returnData);
        }
        /// @notice Use when you _really_ really _really_ don't trust the called
        /// contract. This prevents the called contract from causing reversion of
        /// the caller in as many ways as we can.
        /// @dev The main difference between this and a solidity low-level call is
        /// that we limit the number of bytes that the callee can cause to be
        /// copied to caller memory. This prevents stupid things like malicious
        /// contracts returning 10,000,000 bytes causing a local OOG when copying
        /// to memory.
        /// @param _target The address to call
        /// @param _gas The amount of gas to forward to the remote contract
        /// @param _maxCopy The maximum number of bytes of returndata to copy
        /// to memory.
        /// @param _calldata The data to send to the remote contract
        /// @return success and returndata, as `.call()`. Returndata is capped to
        /// `_maxCopy` bytes.
        function excessivelySafeStaticCall(
            address _target,
            uint256 _gas,
            uint16 _maxCopy,
            bytes memory _calldata
        ) internal view returns (bool, bytes memory) {
            // set up for assembly call
            uint256 _toCopy;
            bool _success;
            bytes memory _returnData = new bytes(_maxCopy);
            // dispatch message to recipient
            // by assembly calling "handle" function
            // we call via assembly to avoid memcopying a very large returndata
            // returned by a malicious contract
            assembly {
                _success := staticcall(
                _gas, // gas
                _target, // recipient
                add(_calldata, 0x20), // inloc
                mload(_calldata), // inlen
                0, // outloc
                0 // outlen
                )
            // limit our copy to 256 bytes
                _toCopy := returndatasize()
                if gt(_toCopy, _maxCopy) {
                    _toCopy := _maxCopy
                }
            // Store the length of the copied bytes
                mstore(_returnData, _toCopy)
            // copy the bytes from returndata[0:_toCopy]
                returndatacopy(add(_returnData, 0x20), 0, _toCopy)
            }
            return (_success, _returnData);
        }
        /**
         * @notice Swaps function selectors in encoded contract calls
         * @dev Allows reuse of encoded calldata for functions with identical
         * argument types but different names. It simply swaps out the first 4 bytes
         * for the new selector. This function modifies memory in place, and should
         * only be used with caution.
         * @param _newSelector The new 4-byte selector
         * @param _buf The encoded contract args
         */
        function swapSelector(bytes4 _newSelector, bytes memory _buf)
        internal
        pure
        {
            require(_buf.length >= 4);
            uint256 _mask = LOW_28_MASK;
            assembly {
            // load the first word of
                let _word := mload(add(_buf, 0x20))
            // mask out the top 4 bytes
            // /x
                _word := and(_word, _mask)
                _word := or(_newSelector, _word)
                mstore(add(_buf, 0x20), _word)
            }
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
    pragma solidity ^0.8.0;
    import "IERC165.sol";
    /**
     * @dev Implementation of the {IERC165} interface.
     *
     * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
     * for the additional interface id that will be supported. For example:
     *
     * ```solidity
     * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
     *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
     * }
     * ```
     *
     * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
     */
    abstract contract ERC165 is IERC165 {
        /**
         * @dev See {IERC165-supportsInterface}.
         */
        function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
            return interfaceId == type(IERC165).interfaceId;
        }
    }
    // SPDX-License-Identifier: MIT
    // OpenZeppelin Contracts (last updated v4.7.0) (interfaces/IERC3156FlashBorrower.sol)
    pragma solidity ^0.8.0;
    /**
     * @dev Interface of the ERC3156 FlashBorrower, as defined in
     * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].
     *
     * _Available since v4.1._
     */
    interface IERC3156FlashBorrower {
        /**
         * @dev Receive a flash loan.
         * @param initiator The initiator of the loan.
         * @param token The loan currency.
         * @param amount The amount of tokens lent.
         * @param fee The additional amount of tokens to repay.
         * @param data Arbitrary data structure, intended to contain user-defined parameters.
         * @return The keccak256 hash of "IERC3156FlashBorrower.onFlashLoan"
         */
        function onFlashLoan(
            address initiator,
            address token,
            uint256 amount,
            uint256 fee,
            bytes calldata data
        ) external returns (bytes32);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity ^0.8.0;
    interface IPrismaCore {
        event FeeReceiverSet(address feeReceiver);
        event GuardianSet(address guardian);
        event NewOwnerAccepted(address oldOwner, address owner);
        event NewOwnerCommitted(address owner, address pendingOwner, uint256 deadline);
        event NewOwnerRevoked(address owner, address revokedOwner);
        event Paused();
        event PriceFeedSet(address priceFeed);
        event Unpaused();
        function acceptTransferOwnership() external;
        function commitTransferOwnership(address newOwner) external;
        function revokeTransferOwnership() external;
        function setFeeReceiver(address _feeReceiver) external;
        function setGuardian(address _guardian) external;
        function setPaused(bool _paused) external;
        function setPriceFeed(address _priceFeed) external;
        function OWNERSHIP_TRANSFER_DELAY() external view returns (uint256);
        function feeReceiver() external view returns (address);
        function guardian() external view returns (address);
        function owner() external view returns (address);
        function ownershipTransferDeadline() external view returns (uint256);
        function paused() external view returns (bool);
        function pendingOwner() external view returns (address);
        function priceFeed() external view returns (address);
        function startTime() external view returns (uint256);
    }