Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Is this a proxy?
• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.17;

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

import { ICegaState } from "./interfaces/ICegaState.sol";
import { Deposit, FCNVaultMetadata, OptionBarrierType, OptionBarrier, VaultStatus, Withdrawal } from "./Structs.sol";
import { FCNVault } from "./FCNVault.sol";
import { Calculations } from "./Calculations.sol";

contract FCNProduct is ReentrancyGuard {
    using SafeERC20 for IERC20;
    using Calculations for FCNVaultMetadata;

    event FCNProductCreated(
        address indexed cegaState,
        address indexed asset,
        string name,
        uint256 managementFeeBps,
        uint256 yieldFeeBps,
        uint256 maxDepositAmountLimit,
        uint256 minDepositAmount,
        uint256 minWithdrawalAmount
    );

    event ManagementFeeBpsUpdated(uint256 managementFeeBps);
    event YieldFeeBpsUpdated(uint256 yieldFeeBps);
    event MinDepositAmountUpdated(uint256 minDepositAmount);
    event MinWithdrawalAmountUpdated(uint256 minWithdrawalAmount);
    event IsDepositQueueOpenUpdated(bool isDepositQueueOpen);
    event MaxDepositAmountLimitUpdated(uint256 maxDepositAmountLimit);

    event VaultCreated(address indexed vaultAddress, string _tokenSymbol, string _tokenName, uint256 _vaultStart);
    event VaultMetadataUpdated(address indexed vaultAddress);
    event VaultRemoved(address indexed vaultAddress);

    event TradeDataSet(
        address indexed vaultAddress,
        uint256 _tradeDate,
        uint256 _tradeExpiry,
        uint256 _aprBps,
        uint256 _tenorInDays
    );

    event OptionBarrierAdded(
        address indexed vaultAddress,
        uint256 barrierBps,
        uint256 barrierAbsoluteValue,
        uint256 strikeBps,
        uint256 strikeAbsoluteValue,
        string asset,
        string oracleName,
        OptionBarrierType barrierType
    );
    event OptionBarrierUpated(
        address indexed vaultAddress,
        uint256 index,
        string _asset,
        uint256 _strikeAbsoluteValue,
        uint256 _barrierAbsoluteValue
    );
    event OptionBarrierOracleUpdated(address indexed vaultAddress, uint256 index, string _asset, string _oracleName);
    event OptionBarrierRemoved(address indexed vaultAddress, uint256 index, string asset);

    event VaultStatusUpdated(address indexed vaultAddress, VaultStatus vaultStatus);

    event DepositQueued(address indexed receiver, uint256 amount);
    event DepositProcessed(address indexed vaultAddress, address indexed receiver, uint256 amount);

    event KnockInStatusUpdated(address indexed vaultAddress, bool isKnockIn);

    event FeesCollected(
        address indexed vaultAddress,
        uint256 managementFee,
        uint256 yieldFee,
        uint256 totalFee,
        VaultStatus vaultStatus
    );

    event WithdrawalQueued(address indexed vaultAddress, address indexed receiver, uint256 amountShares);

    event WithdrawalProcessed(
        address indexed vaultAddress,
        address indexed receiver,
        uint256 amountShares,
        uint256 amountAssets
    );

    event VaultRollover(address indexed vaultAddress, uint256 vaultStart, VaultStatus vaultStatus);

    event VaultFinalPayoffCalculated(address indexed vaultAddress, uint256 finalPayoffAmount, VaultStatus vaultStatus);

    event BarriersChecked(address indexed vaultAddress, bool isKnockedIn);

    event AssetsReceivedFromCegaState(address indexed vaultAddress, uint256 amount);

    event AssetsSentToTrade(
        address indexed vaultAddress,
        address indexed receiver,
        uint256 amount,
        VaultStatus vaultStatus
    );

    ICegaState public cegaState;

    address public immutable asset;
    string public name;
    uint256 public managementFeeBps; // basis points
    uint256 public yieldFeeBps; // basis points
    bool public isDepositQueueOpen;
    uint256 public maxDepositAmountLimit;
    uint256 public minDepositAmount;
    uint256 public minWithdrawalAmount;

    uint256 public sumVaultUnderlyingAmounts;
    uint256 public queuedDepositsTotalAmount;
    uint256 public queuedDepositsCount;

    mapping(address => FCNVaultMetadata) public vaults;
    address[] public vaultAddresses;

    Deposit[] public depositQueue;
    mapping(address => Withdrawal[]) public withdrawalQueues;

    /**
     * @notice Creates a new FCNProduct
     * @param _cegaState is the address of the CegaState contract
     * @param _asset is the underlying asset this product accepts
     * @param _name is the name of the product
     * @param _managementFeeBps is the management fee in bps
     * @param _yieldFeeBps is the yield fee in bps
     * @param _maxDepositAmountLimit is the deposit limit for the product
     * @param _minDepositAmount is the minimum units of underlying for a user to deposit
     * @param _minWithdrawalAmount is the minimum units of vault shares for a user to withdraw
     */
    constructor(
        address _cegaState,
        address _asset,
        string memory _name,
        uint256 _managementFeeBps,
        uint256 _yieldFeeBps,
        uint256 _maxDepositAmountLimit,
        uint256 _minDepositAmount,
        uint256 _minWithdrawalAmount
    ) {
        require(_managementFeeBps < 1e4, "400:IB");
        require(_yieldFeeBps < 1e4, "400:IB");
        require(_minDepositAmount > 0, "400:IU");
        require(_minWithdrawalAmount > 0, "400:IU");

        cegaState = ICegaState(_cegaState);
        asset = _asset;
        name = _name;
        managementFeeBps = _managementFeeBps;
        yieldFeeBps = _yieldFeeBps;
        maxDepositAmountLimit = _maxDepositAmountLimit;
        isDepositQueueOpen = false;

        minDepositAmount = _minDepositAmount;
        minWithdrawalAmount = _minWithdrawalAmount;

        emit FCNProductCreated(
            _cegaState,
            _asset,
            _name,
            _managementFeeBps,
            _yieldFeeBps,
            _maxDepositAmountLimit,
            _minDepositAmount,
            _minWithdrawalAmount
        );
    }

    /**
     * @notice Asserts whether the sender has the DEFAULT_ADMIN_ROLE
     */
    modifier onlyDefaultAdmin() {
        require(cegaState.isDefaultAdmin(msg.sender), "403:DA");
        _;
    }

    /**
     * @notice Asserts whether the sender has the TRADER_ADMIN_ROLE
     */
    modifier onlyTraderAdmin() {
        require(cegaState.isTraderAdmin(msg.sender), "403:TA");
        _;
    }

    /**
     * @notice Asserts whether the sender has the OPERATOR_ADMIN_ROLE
     */
    modifier onlyOperatorAdmin() {
        require(cegaState.isOperatorAdmin(msg.sender), "403:OA");
        _;
    }

    /**
     * @notice Asserts that the vault has been initialized & is a Cega Vault
     * @param vaultAddress is the address of the vault
     */
    modifier onlyValidVault(address vaultAddress) {
        require(vaults[vaultAddress].vaultStart != 0, "400:VA");
        _;
    }

    /**
     * @notice Returns array of vault addresses associated with the product
     */
    function getVaultAddresses() public view returns (address[] memory) {
        return vaultAddresses;
    }

    /**
     * @notice Returns vault metadata for a given vault address, includes OptionBarrier array in output
     * @param vaultAddress is the address of the vault
     */
    function getVaultMetadata(address vaultAddress) public view returns (FCNVaultMetadata memory) {
        return vaults[vaultAddress];
    }

    /**
     * @notice Sets the management fee for the product
     * @param _managementFeeBps is the management fee in bps (100% = 10000)
     */
    function setManagementFeeBps(uint256 _managementFeeBps) public onlyOperatorAdmin {
        require(_managementFeeBps < 1e4, "400:IB");
        managementFeeBps = _managementFeeBps;
        emit ManagementFeeBpsUpdated(_managementFeeBps);
    }

    /**
     * @notice Sets the yieldfee for the product
     * @param _yieldFeeBps is the management fee in bps (100% = 10000)
     */
    function setYieldFeeBps(uint256 _yieldFeeBps) public onlyOperatorAdmin {
        require(_yieldFeeBps < 1e4, "400:IB");
        yieldFeeBps = _yieldFeeBps;
        emit YieldFeeBpsUpdated(_yieldFeeBps);
    }

    /**
     * @notice Sets the min deposit amount for the product
     * @param _minDepositAmount is the minimum units of underlying for a user to deposit
     */
    function setMinDepositAmount(uint256 _minDepositAmount) public onlyOperatorAdmin {
        require(_minDepositAmount > 0, "400:IU");
        minDepositAmount = _minDepositAmount;
        emit MinDepositAmountUpdated(_minDepositAmount);
    }

    /**
     * @notice Sets the min withdrawal amount for the product
     * @param _minWithdrawalAmount is the minimum units of vault shares for a user to withdraw
     */
    function setMinWithdrawalAmount(uint256 _minWithdrawalAmount) public onlyOperatorAdmin {
        require(_minWithdrawalAmount > 0, "400:IU");
        minWithdrawalAmount = _minWithdrawalAmount;
        emit MinWithdrawalAmountUpdated(_minWithdrawalAmount);
    }

    /**
     * @notice Toggles whether the product is open or closed for deposits
     * @param _isDepositQueueOpen is a boolean for whether the deposit queue is accepting deposits
     */
    function setIsDepositQueueOpen(bool _isDepositQueueOpen) public onlyOperatorAdmin {
        isDepositQueueOpen = _isDepositQueueOpen;
        emit IsDepositQueueOpenUpdated(_isDepositQueueOpen);
    }

    /**
     * @notice Sets the maximum deposit limit for the product
     * @param _maxDepositAmountLimit is the deposit limit for the product
     */
    function setMaxDepositAmountLimit(uint256 _maxDepositAmountLimit) public onlyTraderAdmin {
        require(queuedDepositsTotalAmount + sumVaultUnderlyingAmounts <= _maxDepositAmountLimit, "400:TooSmall");
        maxDepositAmountLimit = _maxDepositAmountLimit;
        emit MaxDepositAmountLimitUpdated(_maxDepositAmountLimit);
    }

    /**
     * @notice Creates a new vault for the product & maps the new vault address to the vaultMetadata
     * @param _tokenName is the name of the token for the vault
     * @param _tokenSymbol is the symbol for the vault's token
     * @param _vaultStart is the timestamp of the vault's start
     */
    function createVault(
        string memory _tokenName,
        string memory _tokenSymbol,
        uint256 _vaultStart
    ) public onlyTraderAdmin returns (address vaultAddress) {
        require(_vaultStart != 0, "400:VS");
        FCNVault vault = new FCNVault(asset, _tokenName, _tokenSymbol);
        address newVaultAddress = address(vault);
        vaultAddresses.push(newVaultAddress);

        // vaultMetadata & all of its fields are automatically initialized if it doesn't already exist in the mapping
        FCNVaultMetadata storage vaultMetadata = vaults[newVaultAddress];
        vaultMetadata.vaultStart = _vaultStart;
        vaultMetadata.vaultAddress = newVaultAddress;

        // Leverage is always set to 1
        vaultMetadata.leverage = 1;

        emit VaultCreated(newVaultAddress, _tokenSymbol, _tokenName, _vaultStart);
        return newVaultAddress;
    }

    /**
     * @notice defaultAdmin has the ability to override & change the vaultMetadata
     * If a value is not input, it will override to the default value
     * @param vaultAddress is the address of the vault
     * @param metadata is the vault's metadata that we want to change to
     */
    function setVaultMetadata(
        address vaultAddress,
        FCNVaultMetadata calldata metadata
    ) public onlyDefaultAdmin onlyValidVault(vaultAddress) {
        require(metadata.vaultStart > 0, "400:VS");
        require(metadata.leverage == 1, "400:L");
        vaults[vaultAddress] = metadata;
        emit VaultMetadataUpdated(vaultAddress);
    }

    /**
     * @notice defaultAdmin has the ability to remove a Vault
     * @param i is the index of the vault in the vaultAddresses array
     */
    function removeVault(uint256 i) public onlyDefaultAdmin {
        address vaultAddress = vaultAddresses[i];
        vaultAddresses[i] = vaultAddresses[vaultAddresses.length - 1];
        vaultAddresses.pop();
        delete vaults[vaultAddress];

        emit VaultRemoved(vaultAddress);
    }

    /**
     * @notice Trader admin sets the trade data after the auction
     * @param vaultAddress is the address of the vault
     * @param _tradeDate is the official timestamp of when the options contracts begins
     * @param _tradeExpiry is the timestamp of when the trade will expire
     * @param _aprBps is the APR in bps
     * @param _tenorInDays is the length of the options contract
     */
    function setTradeData(
        address vaultAddress,
        uint256 _tradeDate,
        uint256 _tradeExpiry,
        uint256 _aprBps,
        uint256 _tenorInDays
    ) public onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage metadata = vaults[vaultAddress];
        require(metadata.vaultStatus == VaultStatus.NotTraded, "500:WS");
        require(_tradeDate >= metadata.vaultStart, "400:TD");
        require(_tradeExpiry > _tradeDate, "400:TE");

        // allow for a 1 day difference in input tenor and derived tenor
        uint256 derivedDays = (_tradeExpiry - _tradeDate) / 1 days;
        if (derivedDays < _tenorInDays) {
            require(_tenorInDays - derivedDays <= 1, "400:TN");
        } else {
            require(derivedDays - _tenorInDays <= 1, "400:TN");
        }

        metadata.tradeDate = _tradeDate;
        metadata.tradeExpiry = _tradeExpiry;
        metadata.aprBps = _aprBps;
        metadata.tenorInDays = _tenorInDays;

        emit TradeDataSet(vaultAddress, _tradeDate, _tradeExpiry, _aprBps, _tenorInDays);
    }

    /**
     * @notice Trader admin can add an option with barriers to a given vault
     * @param vaultAddress is the address of the vault
     * @param optionBarrier is the data for the option with barriers
     */
    function addOptionBarrier(
        address vaultAddress,
        OptionBarrier calldata optionBarrier
    ) public onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage metadata = vaults[vaultAddress];
        require(
            metadata.vaultStatus == VaultStatus.DepositsClosed || metadata.vaultStatus == VaultStatus.NotTraded,
            "500:WS"
        );
        metadata.optionBarriers.push(optionBarrier);
        metadata.optionBarriersCount++;

        emit OptionBarrierAdded(
            vaultAddress,
            optionBarrier.barrierBps,
            optionBarrier.barrierAbsoluteValue,
            optionBarrier.strikeBps,
            optionBarrier.strikeAbsoluteValue,
            optionBarrier.asset,
            optionBarrier.oracleName,
            optionBarrier.barrierType
        );
    }

    /**
     * @notice Trader admin has ability to update price fixings & observation time.
     * @param vaultAddress is the address of the vault
     * @param index is the index of the option barrier we want to update
     * @param _asset is the ticker symbol of the asset we want to update
     * (included as a safety check since the asset name should match the option barrier at given index)
     * @param _strikeAbsoluteValue is the actual strike price of the asset
     * @param _barrierAbsoluteValue is the actual price that will cause the barrier to be triggered
     */
    function updateOptionBarrier(
        address vaultAddress,
        uint256 index,
        string calldata _asset,
        uint256 _strikeAbsoluteValue,
        uint256 _barrierAbsoluteValue
    ) public onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];

        require(_strikeAbsoluteValue > 0, "400:SV");
        require(_barrierAbsoluteValue > 0, "400:BV");

        OptionBarrier storage optionBarrier = vaultMetadata.optionBarriers[index];
        require(keccak256(abi.encodePacked(optionBarrier.asset)) == keccak256(abi.encodePacked(_asset)), "400:AS");

        optionBarrier.strikeAbsoluteValue = _strikeAbsoluteValue;
        optionBarrier.barrierAbsoluteValue = _barrierAbsoluteValue;

        emit OptionBarrierUpated(vaultAddress, index, _asset, _strikeAbsoluteValue, _barrierAbsoluteValue);
    }

    /**
     * @notice Operator admin has ability to update the oracle for an option barrier.
     * @param vaultAddress is the address of the vault
     * @param index is the index of the option barrier we want to update
     * @param _asset is the ticker symbol of the asset we want to update
     * (included as a safety check since the asset name should match the option barrier at given index)
     * @param newOracleName is the name of the new oracle (must also register this name in CegaState)
     */
    function updateOptionBarrierOracle(
        address vaultAddress,
        uint256 index,
        string calldata _asset,
        string memory newOracleName
    ) public onlyOperatorAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(
            vaultMetadata.vaultStatus == VaultStatus.DepositsClosed ||
                vaultMetadata.vaultStatus == VaultStatus.NotTraded,
            "500:WS"
        );

        OptionBarrier storage optionBarrier = vaultMetadata.optionBarriers[index];
        require(keccak256(abi.encodePacked(optionBarrier.asset)) == keccak256(abi.encodePacked(_asset)), "400:AS");

        require(cegaState.oracleAddresses(newOracleName) != address(0), "400:OR");
        optionBarrier.oracleName = newOracleName;

        emit OptionBarrierOracleUpdated(vaultAddress, index, _asset, newOracleName);
    }

    /**
     * @notice Trader admin has ability to remove an option barrier.
     * The index for all option barriers to the right of the index are shifted by one to the left.
     * @param vaultAddress is the address of the vault
     * @param index is the index of the option barrier we want to remove
     * @param _asset is the ticker symbol of the asset we want to update
     * (included as a safety check since the asset should match the option barrier at given index)
     */
    function removeOptionBarrier(
        address vaultAddress,
        uint256 index,
        string calldata _asset
    ) public onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(
            vaultMetadata.vaultStatus == VaultStatus.DepositsClosed ||
                vaultMetadata.vaultStatus == VaultStatus.NotTraded,
            "500:WS"
        );

        OptionBarrier[] storage optionBarriers = vaultMetadata.optionBarriers;
        require(
            keccak256(abi.encodePacked(optionBarriers[index].asset)) == keccak256(abi.encodePacked(_asset)),
            "400:AS"
        );

        // swap and pop
        optionBarriers[index] = optionBarriers[optionBarriers.length - 1];
        optionBarriers.pop();
        vaultMetadata.optionBarriersCount -= 1;

        emit OptionBarrierRemoved(vaultAddress, index, _asset);
    }

    /**
     * Operator admin has ability to override the vault's status
     * @param vaultAddress is the address of the vault
     * @param _vaultStatus is the new status for the vault
     */
    function setVaultStatus(
        address vaultAddress,
        VaultStatus _vaultStatus
    ) public onlyOperatorAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage metadata = vaults[vaultAddress];
        metadata.vaultStatus = _vaultStatus;
        emit VaultStatusUpdated(vaultAddress, _vaultStatus);
    }

    /**
     * Trader admin has ability to set the vault to "DepositsOpen" state
     * @param vaultAddress is the address of the vault
     */
    function openVaultDeposits(address vaultAddress) public onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(vaultMetadata.vaultStatus == VaultStatus.DepositsClosed, "500:WS");
        vaultMetadata.vaultStatus = VaultStatus.DepositsOpen;
        emit VaultStatusUpdated(vaultAddress, VaultStatus.DepositsOpen);
    }

    /**
     * Default admin has an override to set the knock in status for a vault
     * @param vaultAddress is the address of the vault
     * @param newState is the new state for isKnockedIn
     */
    function setKnockInStatus(
        address vaultAddress,
        bool newState
    ) public onlyDefaultAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        vaultMetadata.isKnockedIn = newState;
        emit KnockInStatusUpdated(vaultAddress, newState);
    }

    /**
     * Transfers assets from the user to the product
     * @param amount is the amount of assets being deposited
     */
    function addToDepositQueue(uint256 amount) public nonReentrant {
        require(isDepositQueueOpen, "500:NotOpen");
        require(amount >= minDepositAmount, "400:DA");

        queuedDepositsCount += 1;
        queuedDepositsTotalAmount += amount;
        require(queuedDepositsTotalAmount + sumVaultUnderlyingAmounts <= maxDepositAmountLimit, "500:TooBig");

        IERC20(asset).safeTransferFrom(msg.sender, address(this), amount);
        depositQueue.push(Deposit({ amount: amount, receiver: msg.sender }));
        emit DepositQueued(msg.sender, amount);
    }

    /**
     * Processes the product's deposit queue into a specific vault
     * @param vaultAddress is the address of the vault
     * @param maxProcessCount is the number of elements in the deposit queue to be processed
     */
    function processDepositQueue(
        address vaultAddress,
        uint256 maxProcessCount
    ) public nonReentrant onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(vaultMetadata.vaultStatus == VaultStatus.DepositsOpen, "500:WS");

        FCNVault vault = FCNVault(vaultAddress);
        require(!(vaultMetadata.underlyingAmount == 0 && vault.totalSupply() > 0), "500:Z");

        uint256 processCount = Math.min(queuedDepositsCount, maxProcessCount);
        Deposit storage deposit;

        while (processCount > 0) {
            deposit = depositQueue[queuedDepositsCount - 1];

            queuedDepositsTotalAmount -= deposit.amount;
            vault.deposit(deposit.amount, deposit.receiver);
            vaultMetadata.underlyingAmount += deposit.amount;
            sumVaultUnderlyingAmounts += deposit.amount;
            vaultMetadata.currentAssetAmount += deposit.amount;

            depositQueue.pop();
            queuedDepositsCount -= 1;
            processCount -= 1;

            emit DepositProcessed(vaultAddress, deposit.receiver, deposit.amount);
        }

        if (queuedDepositsCount == 0) {
            vaultMetadata.vaultStatus = VaultStatus.NotTraded;
            emit VaultStatusUpdated(vaultAddress, VaultStatus.NotTraded);
        }
    }

    /**
     * @notice Queues a withdrawal for the token holder of a specific vault token
     * @param vaultAddress is the address of the vault
     * @param amountShares is the number of vault tokens to be redeemed
     */
    function addToWithdrawalQueue(
        address vaultAddress,
        uint256 amountShares
    ) public nonReentrant onlyValidVault(vaultAddress) {
        require(amountShares >= minWithdrawalAmount, "400:WA");

        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];

        IERC20(vaultAddress).safeTransferFrom(msg.sender, address(this), amountShares);
        Withdrawal[] storage withdrawalQueue = withdrawalQueues[vaultAddress];
        withdrawalQueue.push(Withdrawal({ amountShares: amountShares, receiver: msg.sender }));
        vaultMetadata.queuedWithdrawalsCount += 1;
        vaultMetadata.queuedWithdrawalsSharesAmount += amountShares;

        emit WithdrawalQueued(vaultAddress, msg.sender, amountShares);
    }

    /**
     * @notice Permissionless method that reads price from oracle contracts and checks if barrier is triggered
     * @param vaultAddress is address of the vault
     */
    function checkBarriers(address vaultAddress) public onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        vaultMetadata.checkBarriers(address(cegaState));
        emit BarriersChecked(vaultAddress, vaultMetadata.isKnockedIn);
    }

    /**
     * @notice Calculates the final payoff for a given vault
     * @param vaultAddress is address of the vault
     */
    function calculateVaultFinalPayoff(
        address vaultAddress
    ) public onlyValidVault(vaultAddress) returns (uint256 vaultFinalPayoff) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        vaultFinalPayoff = vaultMetadata.calculateVaultFinalPayoff(address(cegaState));
        emit VaultFinalPayoffCalculated(vaultAddress, vaultFinalPayoff, VaultStatus.PayoffCalculated);
    }

    /**
     * @notice Calculates the percentage of principal to return to users if a knock in occurs.
     * Iterates through all knock-in barriers and checks the ratio of (spot/strike) for each asset
     * Returns the minimum of the knock-in ratios.
     * @param vaultAddress is address of the vault
     */
    function calculateKnockInRatio(address vaultAddress) public view returns (uint256 knockInRatio) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        return vaultMetadata.calculateKnockInRatio(address(cegaState));
    }

    /**
     * @notice receive assets and allocate the underlying asset to the specified vault's balance
     * @param vaultAddress is the address of the vault
     * @param amount is the amount to transfer
     */
    function receiveAssetsFromCegaState(
        address vaultAddress,
        uint256 amount
    ) public nonReentrant onlyValidVault(vaultAddress) {
        require(msg.sender == address(cegaState), "403:CS");
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];

        IERC20(asset).safeTransferFrom(msg.sender, address(this), amount);
        vaultMetadata.currentAssetAmount += amount;

        emit AssetsReceivedFromCegaState(vaultAddress, amount);
    }

    /**
     * @notice Calculates the fees that should be collected from a given vault
     * @param vaultAddress is the address of the vault
     */
    function calculateFees(
        address vaultAddress
    ) public view returns (uint256 totalFee, uint256 managementFee, uint256 yieldFee) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        return vaultMetadata.calculateFees(managementFeeBps, yieldFeeBps);
    }

    /**
     * @notice Transfers the correct amount of fees to the fee recipient
     * @param vaultAddress is the address of the vault
     */
    function collectFees(address vaultAddress) public nonReentrant onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(vaultMetadata.vaultStatus == VaultStatus.PayoffCalculated, "500:WS");

        (uint256 totalFees, uint256 managementFee, uint256 yieldFee) = calculateFees(vaultAddress);
        totalFees = Math.min(totalFees, vaultMetadata.vaultFinalPayoff);
        IERC20(asset).safeTransfer(cegaState.feeRecipient(), totalFees);
        vaultMetadata.currentAssetAmount -= totalFees;

        vaultMetadata.vaultStatus = VaultStatus.FeesCollected;
        sumVaultUnderlyingAmounts -= vaultMetadata.underlyingAmount;
        vaultMetadata.underlyingAmount = vaultMetadata.vaultFinalPayoff - totalFees;
        sumVaultUnderlyingAmounts += vaultMetadata.underlyingAmount;

        emit FeesCollected(vaultAddress, managementFee, yieldFee, totalFees, VaultStatus.FeesCollected);
    }

    /**
     * @notice Processes all the queued withdrawals in the withdrawal queue
     * @param vaultAddress is the address of the vault
     * @param maxProcessCount is the maximum number of withdrawals to process in the queue
     */
    function processWithdrawalQueue(
        address vaultAddress,
        uint256 maxProcessCount
    ) public nonReentrant onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        // Needs zombie state so that we can restore the vault
        require(
            vaultMetadata.vaultStatus == VaultStatus.FeesCollected || vaultMetadata.vaultStatus == VaultStatus.Zombie,
            "500:WS"
        );
        Withdrawal[] storage withdrawalQueue = withdrawalQueues[vaultAddress];

        FCNVault vault = FCNVault(vaultAddress);

        uint256 processCount = Math.min(vaultMetadata.queuedWithdrawalsCount, maxProcessCount);
        uint256 amountAssets;
        Withdrawal memory withdrawal;
        while (processCount > 0) {
            withdrawal = withdrawalQueue[vaultMetadata.queuedWithdrawalsCount - 1];

            amountAssets = vault.redeem(withdrawal.amountShares);
            vaultMetadata.underlyingAmount -= amountAssets;
            sumVaultUnderlyingAmounts -= amountAssets;
            vaultMetadata.queuedWithdrawalsSharesAmount -= withdrawal.amountShares;
            IERC20(asset).safeTransfer(withdrawal.receiver, amountAssets);
            vaultMetadata.currentAssetAmount -= amountAssets;

            withdrawalQueue.pop();
            vaultMetadata.queuedWithdrawalsCount -= 1;
            processCount -= 1;

            emit WithdrawalProcessed(vaultAddress, withdrawal.receiver, withdrawal.amountShares, amountAssets);
        }

        if (vaultMetadata.queuedWithdrawalsCount == 0) {
            if (vaultMetadata.underlyingAmount == 0 && vault.totalSupply() > 0) {
                vaultMetadata.vaultStatus = VaultStatus.Zombie;
                emit VaultStatusUpdated(vaultAddress, VaultStatus.Zombie);
            } else {
                vaultMetadata.vaultStatus = VaultStatus.WithdrawalQueueProcessed;
                emit VaultStatusUpdated(vaultAddress, VaultStatus.WithdrawalQueueProcessed);
            }
        }
    }

    /**
     * @notice Resets the vault to the default state after the trade is settled
     * @param vaultAddress is the address of the vault
     */
    function rolloverVault(address vaultAddress) public onlyTraderAdmin onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(vaultMetadata.vaultStatus == VaultStatus.WithdrawalQueueProcessed, "500:WS");
        require(vaultMetadata.tradeExpiry != 0, "400:TE");
        vaultMetadata.vaultStart = vaultMetadata.tradeExpiry;
        vaultMetadata.tradeDate = 0;
        vaultMetadata.tradeExpiry = 0;
        vaultMetadata.aprBps = 0;
        vaultMetadata.vaultStatus = VaultStatus.DepositsClosed;
        vaultMetadata.totalCouponPayoff = 0;
        vaultMetadata.vaultFinalPayoff = 0;
        vaultMetadata.isKnockedIn = false;

        emit VaultRollover(vaultAddress, vaultMetadata.vaultStart, VaultStatus.DepositsClosed);
    }

    /**
     * @notice Trader sends assets from the product to a third party wallet address
     * @param vaultAddress is the address of the vault
     * @param receiver is the receiver of the assets
     * @param amount is the amount of the assets to be sent
     */
    function sendAssetsToTrade(
        address vaultAddress,
        address receiver,
        uint256 amount
    ) public nonReentrant onlyTraderAdmin onlyValidVault(vaultAddress) {
        require(cegaState.marketMakerAllowList(receiver), "400:NotAllowed");
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        require(amount <= vaultMetadata.currentAssetAmount, "400:TooBig");
        IERC20(asset).safeTransfer(receiver, amount);
        vaultMetadata.currentAssetAmount = vaultMetadata.currentAssetAmount - amount;
        vaultMetadata.vaultStatus = VaultStatus.Traded;

        emit AssetsSentToTrade(vaultAddress, receiver, amount, VaultStatus.Traded);
    }

    /**
     * @notice Calculates the current yield accumulated to the current day for a given vault
     * @param vaultAddress is the address of the vault
     */
    function calculateCurrentYield(address vaultAddress) public onlyValidVault(vaultAddress) {
        FCNVaultMetadata storage vaultMetadata = vaults[vaultAddress];
        vaultMetadata.calculateCurrentYield();
    }
}

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

pragma solidity ^0.8.0;

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (interfaces/IERC20.sol)

pragma solidity ^0.8.0;

import "../token/ERC20/IERC20.sol";

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (security/ReentrancyGuard.sol)

pragma solidity ^0.8.0;

/**
 * @dev Contract module that helps prevent reentrant calls to a function.
 *
 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
 * available, which can be applied to functions to make sure there are no nested
 * (reentrant) calls to them.
 *
 * Note that because there is a single `nonReentrant` guard, functions marked as
 * `nonReentrant` may not call one another. This can be worked around by making
 * those functions `private`, and then adding `external` `nonReentrant` entry
 * points to them.
 *
 * TIP: If you would like to learn more about reentrancy and alternative ways
 * to protect against it, check out our blog post
 * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
 */
abstract contract ReentrancyGuard {
    // Booleans are more expensive than uint256 or any type that takes up a full
    // word because each write operation emits an extra SLOAD to first read the
    // slot's contents, replace the bits taken up by the boolean, and then write
    // back. This is the compiler's defense against contract upgrades and
    // pointer aliasing, and it cannot be disabled.

    // The values being non-zero value makes deployment a bit more expensive,
    // but in exchange the refund on every call to nonReentrant will be lower in
    // amount. Since refunds are capped to a percentage of the total
    // transaction's gas, it is best to keep them low in cases like this one, to
    // increase the likelihood of the full refund coming into effect.
    uint256 private constant _NOT_ENTERED = 1;
    uint256 private constant _ENTERED = 2;

    uint256 private _status;

    constructor() {
        _status = _NOT_ENTERED;
    }

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

    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, _status will be _NOT_ENTERED
        require(_status != _ENTERED, "ReentrancyGuard: reentrant call");

        // Any calls to nonReentrant after this point will fail
        _status = _ENTERED;
    }

    function _nonReentrantAfter() private {
        // By storing the original value once again, a refund is triggered (see
        // https://eips.ethereum.org/EIPS/eip-2200)
        _status = _NOT_ENTERED;
    }
}

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

pragma solidity ^0.8.0;

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

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

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

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

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

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

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

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

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

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

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

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

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

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

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

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

        return true;
    }

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

        _beforeTokenTransfer(from, to, amount);

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

        emit Transfer(from, to, amount);

        _afterTokenTransfer(from, to, amount);
    }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
 * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
 *
 * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
 * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
 * need to send a transaction, and thus is not required to hold Ether at all.
 */
interface IERC20Permit {
    /**
     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
     * given ``owner``'s signed approval.
     *
     * IMPORTANT: The same issues {IERC20-approve} has related to transaction
     * ordering also apply here.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `deadline` must be a timestamp in the future.
     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
     * over the EIP712-formatted function arguments.
     * - the signature must use ``owner``'s current nonce (see {nonces}).
     *
     * For more information on the signature format, see the
     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
     * section].
     */
    function permit(
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) external;

    /**
     * @dev Returns the current nonce for `owner`. This value must be
     * included whenever a signature is generated for {permit}.
     *
     * Every successful call to {permit} increases ``owner``'s nonce by one. This
     * prevents a signature from being used multiple times.
     */
    function nonces(address owner) external view returns (uint256);

    /**
     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
     */
    // solhint-disable-next-line func-name-mixedcase
    function DOMAIN_SEPARATOR() external view returns (bytes32);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts 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 (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 (last updated v4.8.0) (token/ERC20/utils/SafeERC20.sol)

pragma solidity ^0.8.0;

import "../IERC20.sol";
import "../extensions/draft-IERC20Permit.sol";
import "../../../utils/Address.sol";

/**
 * @title SafeERC20
 * @dev Wrappers around ERC20 operations that throw on failure (when the token
 * contract returns false). Tokens that return no value (and instead revert or
 * throw on failure) are also supported, non-reverting calls are assumed to be
 * successful.
 * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
 * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
 */
library SafeERC20 {
    using Address for address;

    function safeTransfer(
        IERC20 token,
        address to,
        uint256 value
    ) internal {
        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
    }

    function safeTransferFrom(
        IERC20 token,
        address from,
        address to,
        uint256 value
    ) internal {
        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
    }

    /**
     * @dev Deprecated. This function has issues similar to the ones found in
     * {IERC20-approve}, and its usage is discouraged.
     *
     * Whenever possible, use {safeIncreaseAllowance} and
     * {safeDecreaseAllowance} instead.
     */
    function safeApprove(
        IERC20 token,
        address spender,
        uint256 value
    ) internal {
        // safeApprove should only be called when setting an initial allowance,
        // or when resetting it to zero. To increase and decrease it, use
        // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
        require(
            (value == 0) || (token.allowance(address(this), spender) == 0),
            "SafeERC20: approve from non-zero to non-zero allowance"
        );
        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
    }

    function safeIncreaseAllowance(
        IERC20 token,
        address spender,
        uint256 value
    ) internal {
        uint256 newAllowance = token.allowance(address(this), spender) + value;
        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
    }

    function safeDecreaseAllowance(
        IERC20 token,
        address spender,
        uint256 value
    ) internal {
        unchecked {
            uint256 oldAllowance = token.allowance(address(this), spender);
            require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
            uint256 newAllowance = oldAllowance - value;
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
    }

    function safePermit(
        IERC20Permit token,
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) internal {
        uint256 nonceBefore = token.nonces(owner);
        token.permit(owner, spender, value, deadline, v, r, s);
        uint256 nonceAfter = token.nonces(owner);
        require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
    }

    /**
     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
     * on the return value: the return value is optional (but if data is returned, it must not be false).
     * @param token The token targeted by the call.
     * @param data The call data (encoded using abi.encode or one of its variants).
     */
    function _callOptionalReturn(IERC20 token, bytes memory data) private {
        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
        // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
        // the target address contains contract code and also asserts for success in the low-level call.

        bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
        if (returndata.length > 0) {
            // Return data is optional
            require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)

pragma solidity ^0.8.1;

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev Returns true if `account` is a contract.
     *
     * [IMPORTANT]
     * ====
     * It is unsafe to assume that an address for which this function returns
     * false is an externally-owned account (EOA) and not a contract.
     *
     * Among others, `isContract` will return false for the following
     * types of addresses:
     *
     *  - an externally-owned account
     *  - a contract in construction
     *  - an address where a contract will be created
     *  - an address where a contract lived, but was destroyed
     * ====
     *
     * [IMPORTANT]
     * ====
     * You shouldn't rely on `isContract` to protect against flash loan attacks!
     *
     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
     * constructor.
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize/address.code.length, which returns 0
        // for contracts in construction, since the code is only stored at the end
        // of the constructor execution.

        return account.code.length > 0;
    }

    /**
     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
     * `recipient`, forwarding all available gas and reverting on errors.
     *
     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
     * of certain opcodes, possibly making contracts go over the 2300 gas limit
     * imposed by `transfer`, making them unable to receive funds via
     * `transfer`. {sendValue} removes this limitation.
     *
     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
     *
     * IMPORTANT: because control is transferred to `recipient`, care must be
     * taken to not create reentrancy vulnerabilities. Consider using
     * {ReentrancyGuard} or the
     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        require(address(this).balance >= amount, "Address: insufficient balance");

        (bool success, ) = recipient.call{value: amount}("");
        require(success, "Address: unable to send value, recipient may have reverted");
    }

    /**
     * @dev Performs a Solidity function call using a low level `call`. A
     * plain `call` is an unsafe replacement for a function call: use this
     * function instead.
     *
     * If `target` reverts with a revert reason, it is bubbled up by this
     * function (like regular Solidity function calls).
     *
     * Returns the raw returned data. To convert to the expected return value,
     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
     *
     * Requirements:
     *
     * - `target` must be a contract.
     * - calling `target` with `data` must not revert.
     *
     * _Available since v3.1._
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, "Address: low-level call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
     * `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
    }

    /**
     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
     * with `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(address(this).balance >= value, "Address: insufficient balance for call");
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        return functionStaticCall(target, data, "Address: low-level static call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) private pure {
        // Look for revert reason and bubble it up if present
        if (returndata.length > 0) {
            // The easiest way to bubble the revert reason is using memory via assembly
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert(errorMessage);
        }
    }
}

// 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 (last updated v4.8.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.17;

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

import { Deposit, FCNVaultMetadata, OptionBarrierType, OptionBarrier, VaultStatus, Withdrawal } from "./Structs.sol";
import { IOracle } from "./interfaces/IOracle.sol";
import { ICegaState } from "./interfaces/ICegaState.sol";

library Calculations {
    uint256 public constant DAYS_IN_YEAR = 365;
    uint256 public constant SECONDS_TO_DAYS = 86400;
    uint256 public constant BPS_DECIMALS = 10 ** 4;
    uint256 public constant LARGE_CONSTANT = 10 ** 18;
    uint256 public constant ORACLE_STALE_DELAY = 1 days;

    /**
     * @notice Calculates the current yield accumulated to the current day for a given vault
     */
    function calculateCurrentYield(FCNVaultMetadata storage self) public {
        require(self.vaultStatus == VaultStatus.Traded, "500:WS");
        uint256 currentTime = block.timestamp;

        if (currentTime > self.tradeExpiry) {
            self.vaultStatus = VaultStatus.TradeExpired;
            return;
        }

        uint256 numberOfDaysPassed = (currentTime - self.tradeDate) / SECONDS_TO_DAYS;

        self.totalCouponPayoff = calculateCouponPayment(self.underlyingAmount, self.aprBps, numberOfDaysPassed);
    }

    /**
     * @notice Permissionless method that reads price from oracle contracts and checks if barrier is triggered
     * @param cegaStateAddress is the address of the CegaState contract that stores the oracle addresses
     */
    function checkBarriers(FCNVaultMetadata storage self, address cegaStateAddress) public {
        if (self.isKnockedIn == true) {
            return;
        }

        require(self.vaultStatus == VaultStatus.Traded, "500:WS");

        for (uint256 i = 0; i < self.optionBarriersCount; i++) {
            OptionBarrier storage optionBarrier = self.optionBarriers[i];

            // Knock In: Check if current price is less than barrier
            if (optionBarrier.barrierType == OptionBarrierType.KnockIn) {
                address oracle = getOracleAddress(optionBarrier, cegaStateAddress);
                (, int256 answer, uint256 startedAt, , ) = IOracle(oracle).latestRoundData();
                require(block.timestamp - ORACLE_STALE_DELAY <= startedAt, "400:T");
                if (uint256(answer) <= optionBarrier.barrierAbsoluteValue) {
                    self.isKnockedIn = true;
                }
            }
        }
    }

    /**
     * @notice Calculates the final payoff for a given vault
     * @param self is the FCNVaultMetadata
     * @param cegaStateAddress is address of cegaState
     */
    function calculateVaultFinalPayoff(
        FCNVaultMetadata storage self,
        address cegaStateAddress
    ) public returns (uint256) {
        uint256 totalPrincipal;
        uint256 totalCouponPayment;
        uint256 principalToReturnBps = BPS_DECIMALS;

        require(
            (self.vaultStatus == VaultStatus.TradeExpired || self.vaultStatus == VaultStatus.PayoffCalculated),
            "500:WS"
        );

        // Calculate coupon payment
        totalCouponPayment = calculateCouponPayment(self.underlyingAmount, self.aprBps, self.tenorInDays);

        // Calculate principal
        if (self.isKnockedIn) {
            principalToReturnBps = calculateKnockInRatio(self, cegaStateAddress);
        }

        totalPrincipal = (self.underlyingAmount * principalToReturnBps) / BPS_DECIMALS;
        uint256 vaultFinalPayoff = totalPrincipal + totalCouponPayment;
        self.totalCouponPayoff = totalCouponPayment;
        self.vaultFinalPayoff = vaultFinalPayoff;
        self.vaultStatus = VaultStatus.PayoffCalculated;
        return vaultFinalPayoff;
    }

    /**
     * @notice Calculates the percentage of principal to return to users if a knock in occurs.
     * Iterates through all knock-in barriers and checks the ratio of (spot/strike) for each asset
     * Returns the minimum of the knock-in ratios.
     * @param self is the FCNVaultMetadata
     * @param cegaStateAddress is address of cegaState
     */
    function calculateKnockInRatio(
        FCNVaultMetadata storage self,
        address cegaStateAddress
    ) public view returns (uint256) {
        OptionBarrier[] memory optionBarriers = self.optionBarriers;
        uint256 optionBarriersCount = self.optionBarriersCount;

        uint256 minRatioBps = LARGE_CONSTANT;
        for (uint256 i = 0; i < optionBarriersCount; i++) {
            OptionBarrier memory optionBarrier = optionBarriers[i];
            address oracle = getOracleAddress(optionBarrier, cegaStateAddress);
            (, int256 answer, uint256 startedAt, , ) = IOracle(oracle).latestRoundData();
            require(block.timestamp - ORACLE_STALE_DELAY <= startedAt, "400:T");

            // Only calculate the ratio if it is a knock in barrier
            if (optionBarrier.barrierType == OptionBarrierType.KnockIn) {
                uint256 ratioBps = (uint256(answer) * LARGE_CONSTANT) / optionBarrier.strikeAbsoluteValue;
                minRatioBps = Math.min(ratioBps, minRatioBps);
            }
        }
        return ((minRatioBps * BPS_DECIMALS)) / LARGE_CONSTANT;
    }

    /**
     * @notice Calculates the fees that should be collected from a given vault
     * @param managementFeeBps is the management fee in bps
     * @param yieldFeeBps is the yield fee in bps
     */
    function calculateFees(
        FCNVaultMetadata storage self,
        uint256 managementFeeBps,
        uint256 yieldFeeBps
    ) public view returns (uint256, uint256, uint256) {
        uint256 totalFee = 0;
        uint256 managementFee = 0;
        uint256 yieldFee = 0;

        uint256 underlyingAmount = self.underlyingAmount;
        uint256 numberOfDaysPassed = (self.tradeExpiry - self.vaultStart) / SECONDS_TO_DAYS;

        managementFee =
            (underlyingAmount * numberOfDaysPassed * managementFeeBps * LARGE_CONSTANT) /
            DAYS_IN_YEAR /
            BPS_DECIMALS /
            LARGE_CONSTANT;

        if (self.vaultFinalPayoff > underlyingAmount) {
            uint256 profit = self.vaultFinalPayoff - underlyingAmount;
            yieldFee = (profit * yieldFeeBps) / BPS_DECIMALS;
        }

        totalFee = managementFee + yieldFee;
        return (totalFee, managementFee, yieldFee);
    }

    /**
     * @notice Calculates the coupon payment accumulated for a given number of daysPassed
     * @param underlyingAmount is the amount of assets
     * @param aprBps is the apr in bps
     * @param daysPassed is the number of days that coupon payments have been accured for
     */
    function calculateCouponPayment(
        uint256 underlyingAmount,
        uint256 aprBps,
        uint256 daysPassed
    ) private pure returns (uint256) {
        return (underlyingAmount * daysPassed * aprBps * LARGE_CONSTANT) / DAYS_IN_YEAR / BPS_DECIMALS / LARGE_CONSTANT;
    }

    /**
     * @notice Gets the oracle address for a given optionBarrier
     * @param optionBarrier is the option barrier
     * @param cegaStateAddress is the address of the Cega state contract
     */
    function getOracleAddress(
        OptionBarrier memory optionBarrier,
        address cegaStateAddress
    ) private view returns (address) {
        ICegaState cegaState = ICegaState(cegaStateAddress);
        address oracle = cegaState.oracleAddresses(optionBarrier.oracleName);
        require(oracle != address(0), "400:Unregistered");
        return oracle;
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.13;

import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";

import { FCNProduct } from "./FCNProduct.sol";
import { FCNVaultMetadata, VaultStatus } from "./Structs.sol";

contract FCNVault is ERC20, Ownable {
    using SafeERC20 for ERC20;

    address public asset;
    FCNProduct public fcnProduct;

    /**
     * @notice Creates a new FCNVault that is owned by the FCNProduct
     * @param _asset is the address of the underlying asset
     * @param _tokenName is the name of the token
     * @param _tokenSymbol is the name of the token symbol
     */
    constructor(address _asset, string memory _tokenName, string memory _tokenSymbol) ERC20(_tokenName, _tokenSymbol) {
        asset = _asset;
        fcnProduct = FCNProduct(owner());
    }

    function decimals() public view virtual override returns (uint8) {
        return 6;
    }

    /**
     * @notice Returns underlying amount associated for the vault
     */
    function totalAssets() public view returns (uint256) {
        (, , , , , uint256 underlyingAmount, , , , , , , , , , ) = fcnProduct.vaults(address(this));
        return underlyingAmount;
    }

    /**
     * @notice Converts units of shares to assets
     * @param shares is the number of vault tokens
     */
    function convertToAssets(uint256 shares) public view returns (uint256) {
        uint256 _totalSupply = totalSupply();
        if (_totalSupply == 0) return 0;
        return (shares * totalAssets()) / _totalSupply;
    }

    /**
     * @notice Converts units assets to shares
     * @param assets is the amount of underlying assets
     */
    function convertToShares(uint256 assets) public view returns (uint256) {
        uint256 _totalSupply = totalSupply();
        uint256 _totalAssets = totalAssets();
        if (_totalAssets == 0 || _totalSupply == 0) return assets;
        return (assets * _totalSupply) / _totalAssets;
    }

    /**
     * Product can deposit into the vault
     * @param assets is the number of underlying assets to be deposited
     * @param receiver is the address of the original depositor
     */
    function deposit(uint256 assets, address receiver) public onlyOwner returns (uint256) {
        uint256 shares = convertToShares(assets);

        _mint(receiver, shares);

        return shares;
    }

    /**
     * Redeem a given amount of shares in return for assets
     * Shares are burned from the caller
     * @param shares is the amount of shares (vault tokens) to be redeemed
     */
    function redeem(uint256 shares) external onlyOwner returns (uint256) {
        uint256 assets = convertToAssets(shares);

        _burn(msg.sender, shares);

        return assets;
    }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

interface IAggregatorV3 {
    function decimals() external view returns (uint8);

    function description() external view returns (string memory);

    function version() external view returns (uint256);

    function getRoundData(
        uint80 _roundId
    )
        external
        view
        returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound);

    function latestRoundData()
        external
        view
        returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.17;

interface ICegaState {
    function marketMakerAllowList(address marketMaker) external view returns (bool);

    function products(string memory productName) external view returns (address);

    function oracleAddresses(string memory oracleName) external view returns (address);

    function oracleNames() external view returns (string[] memory);

    function productNames() external view returns (string[] memory);

    function feeRecipient() external view returns (address);

    function isDefaultAdmin(address sender) external view returns (bool);

    function isTraderAdmin(address sender) external view returns (bool);

    function isOperatorAdmin(address sender) external view returns (bool);

    function isServiceAdmin(address sender) external view returns (bool);

    function getOracleNames() external view returns (string[] memory);

    function addOracle(string memory oracleName, address oracleAddress) external;

    function removeOracle(string memory oracleName) external;

    function getProductNames() external view returns (string[] memory);

    function addProduct(string memory productName, address product) external;

    function removeProduct(string memory productName) external;

    function updateMarketMakerPermission(address marketMaker, bool allow) external;

    function setFeeRecipient(address _feeRecipient) external;

    function moveAssetsToProduct(string memory productName, address vaultAddress, uint256 amount) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.17;

import { IAggregatorV3 } from "./IAggregatorV3.sol";
import { RoundData } from "../Structs.sol";

interface IOracle is IAggregatorV3 {
    function decimals() external view returns (uint8);

    function description() external view returns (string memory);

    function version() external view returns (uint256);

    function cegaState() external view returns (address);

    function oracleData() external view returns (RoundData[] memory);

    function nextRoundId() external view returns (uint80);

    function addNextRoundData(RoundData calldata _roundData) external;

    function updateRoundData(uint80 roundId, RoundData calldata _roundData) external;

    function getRoundData(
        uint80 _roundId
    )
        external
        view
        returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound);

    function latestRoundData()
        external
        view
        returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.17;

enum OptionBarrierType {
    None,
    KnockIn
}

struct Deposit {
    uint256 amount;
    address receiver;
}

struct Withdrawal {
    uint256 amountShares;
    address receiver;
}

enum VaultStatus {
    DepositsClosed,
    DepositsOpen,
    NotTraded,
    Traded,
    TradeExpired,
    PayoffCalculated,
    FeesCollected,
    WithdrawalQueueProcessed,
    Zombie
}

struct OptionBarrier {
    uint256 barrierBps;
    uint256 barrierAbsoluteValue;
    uint256 strikeBps;
    uint256 strikeAbsoluteValue;
    string asset;
    string oracleName;
    OptionBarrierType barrierType;
}

struct FCNVaultMetadata {
    uint256 vaultStart;
    uint256 tradeDate;
    uint256 tradeExpiry;
    uint256 aprBps;
    uint256 tenorInDays;
    uint256 underlyingAmount; // This is how many assets were ever deposited into the vault
    uint256 currentAssetAmount; // This is how many assets are currently allocated for the vault (not sent for trade)
    uint256 totalCouponPayoff;
    uint256 vaultFinalPayoff;
    uint256 queuedWithdrawalsSharesAmount;
    uint256 queuedWithdrawalsCount;
    uint256 optionBarriersCount;
    uint256 leverage;
    address vaultAddress;
    VaultStatus vaultStatus;
    bool isKnockedIn;
    OptionBarrier[] optionBarriers;
}

struct RoundData {
    int256 answer;
    uint256 startedAt;
    uint256 updatedAt;
    uint80 answeredInRound;
}

{
  "metadata": {
    "bytecodeHash": "none"
  },
  "optimizer": {
    "enabled": true,
    "runs": 200,
    "details": {
      "yul": true
    }
  },
  "viaIR": true,
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "libraries": {
    "contracts/Calculations.sol": {
      "Calculations": "0xb517944479e3e85ec1d26f607db9193706733d30"
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"_cegaState","type":"address"},{"internalType":"address","name":"_asset","type":"address"},{"internalType":"string","name":"_name","type":"string"},{"internalType":"uint256","name":"_managementFeeBps","type":"uint256"},{"internalType":"uint256","name":"_yieldFeeBps","type":"uint256"},{"internalType":"uint256","name":"_maxDepositAmountLimit","type":"uint256"},{"internalType":"uint256","name":"_minDepositAmount","type":"uint256"},{"internalType":"uint256","name":"_minWithdrawalAmount","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"AssetsReceivedFromCegaState","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"}],"name":"AssetsSentToTrade","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"bool","name":"isKnockedIn","type":"bool"}],"name":"BarriersChecked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"DepositProcessed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"DepositQueued","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"cegaState","type":"address"},{"indexed":true,"internalType":"address","name":"asset","type":"address"},{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"uint256","name":"managementFeeBps","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"yieldFeeBps","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"maxDepositAmountLimit","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"minDepositAmount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"minWithdrawalAmount","type":"uint256"}],"name":"FCNProductCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"managementFee","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"yieldFee","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"totalFee","type":"uint256"},{"indexed":false,"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"}],"name":"FeesCollected","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"isDepositQueueOpen","type":"bool"}],"name":"IsDepositQueueOpenUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"bool","name":"isKnockIn","type":"bool"}],"name":"KnockInStatusUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"managementFeeBps","type":"uint256"}],"name":"ManagementFeeBpsUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"maxDepositAmountLimit","type":"uint256"}],"name":"MaxDepositAmountLimitUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"minDepositAmount","type":"uint256"}],"name":"MinDepositAmountUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"minWithdrawalAmount","type":"uint256"}],"name":"MinWithdrawalAmountUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"barrierBps","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"barrierAbsoluteValue","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"strikeBps","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"strikeAbsoluteValue","type":"uint256"},{"indexed":false,"internalType":"string","name":"asset","type":"string"},{"indexed":false,"internalType":"string","name":"oracleName","type":"string"},{"indexed":false,"internalType":"enum OptionBarrierType","name":"barrierType","type":"uint8"}],"name":"OptionBarrierAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"index","type":"uint256"},{"indexed":false,"internalType":"string","name":"_asset","type":"string"},{"indexed":false,"internalType":"string","name":"_oracleName","type":"string"}],"name":"OptionBarrierOracleUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"index","type":"uint256"},{"indexed":false,"internalType":"string","name":"asset","type":"string"}],"name":"OptionBarrierRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"index","type":"uint256"},{"indexed":false,"internalType":"string","name":"_asset","type":"string"},{"indexed":false,"internalType":"uint256","name":"_strikeAbsoluteValue","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_barrierAbsoluteValue","type":"uint256"}],"name":"OptionBarrierUpated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"_tradeDate","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_tradeExpiry","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_aprBps","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_tenorInDays","type":"uint256"}],"name":"TradeDataSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"string","name":"_tokenSymbol","type":"string"},{"indexed":false,"internalType":"string","name":"_tokenName","type":"string"},{"indexed":false,"internalType":"uint256","name":"_vaultStart","type":"uint256"}],"name":"VaultCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"finalPayoffAmount","type":"uint256"},{"indexed":false,"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"}],"name":"VaultFinalPayoffCalculated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"}],"name":"VaultMetadataUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"}],"name":"VaultRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"vaultStart","type":"uint256"},{"indexed":false,"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"}],"name":"VaultRollover","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":false,"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"}],"name":"VaultStatusUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amountShares","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amountAssets","type":"uint256"}],"name":"WithdrawalProcessed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vaultAddress","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amountShares","type":"uint256"}],"name":"WithdrawalQueued","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"yieldFeeBps","type":"uint256"}],"name":"YieldFeeBpsUpdated","type":"event"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"components":[{"internalType":"uint256","name":"barrierBps","type":"uint256"},{"internalType":"uint256","name":"barrierAbsoluteValue","type":"uint256"},{"internalType":"uint256","name":"strikeBps","type":"uint256"},{"internalType":"uint256","name":"strikeAbsoluteValue","type":"uint256"},{"internalType":"string","name":"asset","type":"string"},{"internalType":"string","name":"oracleName","type":"string"},{"internalType":"enum OptionBarrierType","name":"barrierType","type":"uint8"}],"internalType":"struct OptionBarrier","name":"optionBarrier","type":"tuple"}],"name":"addOptionBarrier","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"addToDepositQueue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"amountShares","type":"uint256"}],"name":"addToWithdrawalQueue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"asset","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"calculateCurrentYield","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"calculateFees","outputs":[{"internalType":"uint256","name":"totalFee","type":"uint256"},{"internalType":"uint256","name":"managementFee","type":"uint256"},{"internalType":"uint256","name":"yieldFee","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"calculateKnockInRatio","outputs":[{"internalType":"uint256","name":"knockInRatio","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"calculateVaultFinalPayoff","outputs":[{"internalType":"uint256","name":"vaultFinalPayoff","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"cegaState","outputs":[{"internalType":"contract ICegaState","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"checkBarriers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"collectFees","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_tokenName","type":"string"},{"internalType":"string","name":"_tokenSymbol","type":"string"},{"internalType":"uint256","name":"_vaultStart","type":"uint256"}],"name":"createVault","outputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"depositQueue","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getVaultAddresses","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"getVaultMetadata","outputs":[{"components":[{"internalType":"uint256","name":"vaultStart","type":"uint256"},{"internalType":"uint256","name":"tradeDate","type":"uint256"},{"internalType":"uint256","name":"tradeExpiry","type":"uint256"},{"internalType":"uint256","name":"aprBps","type":"uint256"},{"internalType":"uint256","name":"tenorInDays","type":"uint256"},{"internalType":"uint256","name":"underlyingAmount","type":"uint256"},{"internalType":"uint256","name":"currentAssetAmount","type":"uint256"},{"internalType":"uint256","name":"totalCouponPayoff","type":"uint256"},{"internalType":"uint256","name":"vaultFinalPayoff","type":"uint256"},{"internalType":"uint256","name":"queuedWithdrawalsSharesAmount","type":"uint256"},{"internalType":"uint256","name":"queuedWithdrawalsCount","type":"uint256"},{"internalType":"uint256","name":"optionBarriersCount","type":"uint256"},{"internalType":"uint256","name":"leverage","type":"uint256"},{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"},{"internalType":"bool","name":"isKnockedIn","type":"bool"},{"components":[{"internalType":"uint256","name":"barrierBps","type":"uint256"},{"internalType":"uint256","name":"barrierAbsoluteValue","type":"uint256"},{"internalType":"uint256","name":"strikeBps","type":"uint256"},{"internalType":"uint256","name":"strikeAbsoluteValue","type":"uint256"},{"internalType":"string","name":"asset","type":"string"},{"internalType":"string","name":"oracleName","type":"string"},{"internalType":"enum OptionBarrierType","name":"barrierType","type":"uint8"}],"internalType":"struct OptionBarrier[]","name":"optionBarriers","type":"tuple[]"}],"internalType":"struct FCNVaultMetadata","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isDepositQueueOpen","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"managementFeeBps","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxDepositAmountLimit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minDepositAmount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minWithdrawalAmount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"openVaultDeposits","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"maxProcessCount","type":"uint256"}],"name":"processDepositQueue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"maxProcessCount","type":"uint256"}],"name":"processWithdrawalQueue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"queuedDepositsCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"queuedDepositsTotalAmount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"receiveAssetsFromCegaState","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"string","name":"_asset","type":"string"}],"name":"removeOptionBarrier","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"i","type":"uint256"}],"name":"removeVault","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"}],"name":"rolloverVault","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"sendAssetsToTrade","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_isDepositQueueOpen","type":"bool"}],"name":"setIsDepositQueueOpen","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"bool","name":"newState","type":"bool"}],"name":"setKnockInStatus","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_managementFeeBps","type":"uint256"}],"name":"setManagementFeeBps","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_maxDepositAmountLimit","type":"uint256"}],"name":"setMaxDepositAmountLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_minDepositAmount","type":"uint256"}],"name":"setMinDepositAmount","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_minWithdrawalAmount","type":"uint256"}],"name":"setMinWithdrawalAmount","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"_tradeDate","type":"uint256"},{"internalType":"uint256","name":"_tradeExpiry","type":"uint256"},{"internalType":"uint256","name":"_aprBps","type":"uint256"},{"internalType":"uint256","name":"_tenorInDays","type":"uint256"}],"name":"setTradeData","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"components":[{"internalType":"uint256","name":"vaultStart","type":"uint256"},{"internalType":"uint256","name":"tradeDate","type":"uint256"},{"internalType":"uint256","name":"tradeExpiry","type":"uint256"},{"internalType":"uint256","name":"aprBps","type":"uint256"},{"internalType":"uint256","name":"tenorInDays","type":"uint256"},{"internalType":"uint256","name":"underlyingAmount","type":"uint256"},{"internalType":"uint256","name":"currentAssetAmount","type":"uint256"},{"internalType":"uint256","name":"totalCouponPayoff","type":"uint256"},{"internalType":"uint256","name":"vaultFinalPayoff","type":"uint256"},{"internalType":"uint256","name":"queuedWithdrawalsSharesAmount","type":"uint256"},{"internalType":"uint256","name":"queuedWithdrawalsCount","type":"uint256"},{"internalType":"uint256","name":"optionBarriersCount","type":"uint256"},{"internalType":"uint256","name":"leverage","type":"uint256"},{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"},{"internalType":"bool","name":"isKnockedIn","type":"bool"},{"components":[{"internalType":"uint256","name":"barrierBps","type":"uint256"},{"internalType":"uint256","name":"barrierAbsoluteValue","type":"uint256"},{"internalType":"uint256","name":"strikeBps","type":"uint256"},{"internalType":"uint256","name":"strikeAbsoluteValue","type":"uint256"},{"internalType":"string","name":"asset","type":"string"},{"internalType":"string","name":"oracleName","type":"string"},{"internalType":"enum OptionBarrierType","name":"barrierType","type":"uint8"}],"internalType":"struct OptionBarrier[]","name":"optionBarriers","type":"tuple[]"}],"internalType":"struct FCNVaultMetadata","name":"metadata","type":"tuple"}],"name":"setVaultMetadata","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"enum VaultStatus","name":"_vaultStatus","type":"uint8"}],"name":"setVaultStatus","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_yieldFeeBps","type":"uint256"}],"name":"setYieldFeeBps","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"sumVaultUnderlyingAmounts","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"string","name":"_asset","type":"string"},{"internalType":"uint256","name":"_strikeAbsoluteValue","type":"uint256"},{"internalType":"uint256","name":"_barrierAbsoluteValue","type":"uint256"}],"name":"updateOptionBarrier","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"string","name":"_asset","type":"string"},{"internalType":"string","name":"newOracleName","type":"string"}],"name":"updateOptionBarrierOracle","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"vaultAddresses","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"vaults","outputs":[{"internalType":"uint256","name":"vaultStart","type":"uint256"},{"internalType":"uint256","name":"tradeDate","type":"uint256"},{"internalType":"uint256","name":"tradeExpiry","type":"uint256"},{"internalType":"uint256","name":"aprBps","type":"uint256"},{"internalType":"uint256","name":"tenorInDays","type":"uint256"},{"internalType":"uint256","name":"underlyingAmount","type":"uint256"},{"internalType":"uint256","name":"currentAssetAmount","type":"uint256"},{"internalType":"uint256","name":"totalCouponPayoff","type":"uint256"},{"internalType":"uint256","name":"vaultFinalPayoff","type":"uint256"},{"internalType":"uint256","name":"queuedWithdrawalsSharesAmount","type":"uint256"},{"internalType":"uint256","name":"queuedWithdrawalsCount","type":"uint256"},{"internalType":"uint256","name":"optionBarriersCount","type":"uint256"},{"internalType":"uint256","name":"leverage","type":"uint256"},{"internalType":"address","name":"vaultAddress","type":"address"},{"internalType":"enum VaultStatus","name":"vaultStatus","type":"uint8"},{"internalType":"bool","name":"isKnockedIn","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"withdrawalQueues","outputs":[{"internalType":"uint256","name":"amountShares","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"yieldFeeBps","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]

0x60808060405260043610156200001457600080fd5b600090813560e01c90816306fdde031462003d3e57508063086b48481462003b3d5780630935c6c9146200396b5780632a80cda314620038d25780632ab80c5a14620038b25780632b8fa44b14620035355780632e3e5730146200345f5780632f87045c14620034345780633813c35a146200341457806338d52e0f14620033cd5780633a64f1f51462003332578063405f2c32146200328b57806340e8d7031462002ed657806357a925421462002d87578063596dfbe41462002c3b57806359c1c1421462002c1b578063645006ca1462002bfb5780636ec354f81462002bdb57806377ce02011462002b405780637edf96c51462002a6a5780638312f1491462002a4a57806383290a3c14620029bd57806385b5b14d14620028fe5780638e575a8514620027495780638fef16d5146200254757806393da89ef146200247957806394cb9ffd146200244257806396ad984f14620023cd57806396ce94bf14620022c2578063a480ca791462002087578063a622ee7c1462001f86578063a63c16bb1462001e77578063b379e0bf1462001dd5578063b4d9fab41462001cdc578063b5eb627a1462001abd578063b732f2f114620019ae578063b7d181451462001690578063bcd0fb2f1462001568578063d7bfe3861462001509578063dc4f1e4914620010c0578063e16c1e3d1462000d46578063eaadd9761462000b27578063f14c1b791462000651578063f2cbc0a41462000631578063f343cff01462000530578063f62912c61462000510578063f941911214620004eb5763fb0c18b2146200026257600080fd5b34620004e857600319604036820112620004e4576200028062003fd1565b60248035926001600160401b038411620004e05760e084600401918536030112620004e057600154604051630ddd3b3160e21b81523360048201526020946001600160a01b0392909190869082908790829087165afa8015620004d557620002f1918991620004a1575b5062004215565b1693848652600c84526200030b60408720541515620042c5565b848652600c84526040862060ff600d82015460a01c1660098110156200048e578062000342911590811562000482575b5062004661565b600e8101805490600160401b8210156200046f5790620003689160018201815562004703565b6200045c57906200037c84600b936200445d565b0180546000198114620004495760010190556200039d6084820183620043c5565b9094620003ae60a4840185620043c5565b60c485013594600286101562000445577f92c62627750f7b8794a1c6e3d86147b8a70fcd64b5ff58240c50808d68faf326986200043f956064620004249362000433976040519c8d9c358d52820135908c0152604481013560408c0152013560608a015260e060808a015260e089019162004720565b9186830360a088015262004720565b9160c08401906200414b565b0390a280f35b8a80fd5b634e487b7160e01b885260116004528488fd5b634e487b7160e01b885260048890528488fd5b634e487b7160e01b895260416004528589fd5b6002915014386200033b565b634e487b7160e01b885260216004528488fd5b620004c69150873d8911620004cd575b620004bd818362003ebb565b81019062004159565b38620002ea565b503d620004b1565b6040513d8a823e3d90fd5b8480fd5b5080fd5b80fd5b5034620004e85780600319360112620004e857602060ff600554166040519015158152f35b5034620004e85780600319360112620004e8576020600954604051908152f35b5034620004e8576040366003190112620004e8576200054e62003fd1565b6024359060098210156200062d576001546040516373561c3b60e01b8152336004820152916020916001600160a01b03919083908590602490829086165afa938415620006225760008051602062005fc083398151915294620005ba91889162000600575b5062004173565b1692838552600c8252620005d460408620541515620042c5565b838552600c8252620005ed81600d6040882001620042fb565b620005fc6040518092620040ef565ba280f35b6200061b9150853d8711620004cd57620004bd818362003ebb565b38620005b3565b6040513d88823e3d90fd5b8280fd5b5034620004e85780600319360112620004e8576020600b54604051908152f35b5034620004e8576040366003190112620004e8576200066f62003fd1565b6024356200067c62004953565b600154604051630ddd3b3160e21b815233600482015290602090829060249082906001600160a01b03165afa80156200089457620006c291859162000b0a575062004215565b6001600160a01b0382168352600c6020526040832054620006e5901515620042c5565b6001600160a01b0382168352600c60205260408320600d81015490919060a01c60ff16600981101562000af6578060066200072a921490811562000aea575062004661565b6001600160a01b0383168452600f60205260408420600a83015490918082101562000ae257505b80856020604051620007638162003e6e565b82815201525b6200089f575050600a8101541562000784575b826001815580f35b600581015415806200081e575b15620007dc57600d01805460ff60a01b1916600160a31b179055604051600881526001600160a01b039091169060008051602062005fc083398151915290602090a25b38806200077c565b600d01805460ff60a01b1916600760a01b179055604051600781526001600160a01b039091169060008051602062005fc083398151915290602090a2620007d4565b506040516318160ddd60e01b81526020816004816001600160a01b0387165afa9081156200089457849162000857575b50151562000791565b90506020813d6020116200088b575b81620008756020938362003ebb565b81010312620008865751386200084e565b600080fd5b3d915062000866565b6040513d86823e3d90fd5b600a8301548060001981011162000ace57620008c0906000190183620040d2565b5060405191620008d08362003e6e565b8154918284526001808060a01b039101541660208401526040519163db006a7560e01b835260048301526020826024818a60018060a01b038b165af191821562000ac357879262000a89575b506200092d82600587015462004653565b6005860155620009408260095462004653565b600955620009548351600987015462004653565b60098601556020830151620009999083906001600160a01b03908116907f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb481662004c7e565b620009a982600687015462004653565b60068601558354801562000a755760001901620009d2620009cb8287620040d2565b9062004bad565b8455600a850154600019810190811162000a6157600a8601558060001981011162000a4d576000190191829160018060a01b0360208301511691519060405191825260208201527fb725639f4649132349e51e17d76fbc44211d80a97a1966578878f86113f70721604060018060a01b03891692a362000769565b634e487b7160e01b87526011600452602487fd5b634e487b7160e01b88526011600452602488fd5b634e487b7160e01b88526031600452602488fd5b9091506020813d60201162000aba575b8162000aa86020938362003ebb565b8101031262000886575190386200091c565b3d915062000a99565b6040513d89823e3d90fd5b634e487b7160e01b86526011600452602486fd5b905062000751565b6008915014386200033b565b634e487b7160e01b85526021600452602485fd5b620004c6915060203d602011620004cd57620004bd818362003ebb565b5034620004e857602080600319360112620004e4576004359060018060a01b03602482826001541660405192838092632c9556a560e11b82523360048301525afa801562000d3b5762000b8391869162000d19575b506200428f565b8062000b8f8462004113565b90549060031b1c1692600d54906000199182810190811162000a4d579062000bcf8462000bc062000bf39462004113565b90549060031b1c169162004113565b90919082549060031b9160018060a01b039283811b93849216901b16911916179055565b600d54801562000d0557019062000c0a8262004113565b909182549160031b1b19169055600d55818352600c81526040832090838255836001830155836002830155836003830155836004830155836005830155836006830155600e600792858482015585600882015585600982015585600a82015585600b82015585600c82015585600d8201550190815491600081558262000cb4575b85857fe71f3a50e5ad81964f352c411f1d45e35438ecd1acecef59ac81d9fbbf6cbc0a8280a280f35b828402928484040362000cef57600052600020908101905b81811062000cdb578062000c8b565b8062000ce884926200438b565b0162000ccc565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b86526031600452602486fd5b62000d349150843d8611620004cd57620004bd818362003ebb565b3862000b7c565b6040513d87823e3d90fd5b5034620004e857600319604036820112620004e45762000d6562003fd1565b60248035916001600160401b03808411620010bc5761022084360395860112620010bc5760018054604051632c9556a560e11b815233600482015291956001600160a01b0394602093919284908390899082908a165afa918215620010b157869262000dd9918c916200109657506200428f565b1696878952600c835262000df360408a20541515620042c5565b81600401359462000e0686151562004259565b610184830135958887036200106a57898b52600c855260408b20908155878401358982015560448401356002820155606484013560038201556084840135600482015560a4840135600582015560c4840135600682015560079660e48501358883015561010485013560088301556101248501356009830155610144850135600a830155610164850135600b830155600c820155600d8101916101a4850135908116809103620010665782546001600160a01b0319161782556101c48401356009811015620010665762000edb9083620042fb565b6101e48401359182151583036200106657805460ff60a81b191692151560a81b60ff60a81b1692909217909155600e019161020481013591602219018212156200105e570194600486013593841162001062578086018460051b360381136200105e57600160401b85116200104957825485845580861062000fd1575b509593959189528289209189946101021981360301915b88871062000fa0578b8b7f101bd42603a86fc9bba62795f00899c5afb1147cb5db2a5bd9e0bb1e9b335de88280a280f35b8035908382121562000fcd5786899162000fc0878e95870101896200445d565b0195019601959362000f6f565b8c80fd5b8087029087820403620010345785870287810487036200101f578790856000528660002092830192015b8281106200100b57505062000f58565b62001016816200438b565b01879062000ffb565b83634e487b7160e01b60005260116004526000fd5b82634e487b7160e01b60005260116004526000fd5b50634e487b7160e01b60009081526041600452fd5b8980fd5b8880fd5b8b80fd5b60405162461bcd60e51b8152600481018690526005818a0152640d0c0c0e9360da1b6044820152606490fd5b62000d349150863d8811620004cd57620004bd818362003ebb565b6040513d8c823e3d90fd5b8580fd5b5034620004e8576020366003190112620004e857620010de62003fd1565b6060610200604051620010f18162003e9e565b84815284602082015284604082015284838201528460808201528460a08201528460c08201528460e08201528461010082015284610120820152846101408201528461016082015284610180820152846101a0820152846101c0820152846101e0820152015260018060a01b03168152600c6020526040812090604051916200117a8362003e9e565b8054835260018101546020840152600281015460408401526003810154606084015260048101546080840152600581015460a0840152600681015460c0840152600781015460e084015260088101546101008401526009810154610120840152600a810154610140840152600b810154610160840152600c810154610180840152600d81015460018060a01b0381166101a0850152600960ff8260a01c161015620014f5578060ff809260a01c166101c086015260a81c1615156101e0840152600e810154906001600160401b038211620014e157604051916200126560208260051b018462003ebb565b808352600e60208401920184526020842084925b8284106200141d57610200878787838301526040519283926020845280516020850152602081015160408501526040810151606085015260608101516080850152608081015160a085015260a081015160c085015260c081015160e085015260e08101516101008501526101008101516101208501526101208101516101408501526101408101516101608501526101608101516101808501526101808101516101a085015260018060a01b036101a0820151166101c0850152620013496101c08201516101e0860190620040ef565b6101e081015115158285015201519061022080840152610240830182518091526102606020818601918360051b870101940192905b8282106200138e57505050500390f35b91936001919395506020809161025f198982030185526200140c885191825181528383015184820152604083015160408201526060830151606082015260c08062001400620013ed608087015160e0608087015260e086019062003f8f565b60a087015185820360a087015262003f8f565b9401519101906200414b565b96019201920185949391926200137e565b6040518060e08101106001600160401b0360e083011117620014cb5760e0810160405282548152600183015460208201526002830154604082015260038301546060820152620014706004840162003edd565b6080820152620014836005840162003edd565b60a082015260ff6006840154166002811015620014b7576001928260209260c0600795015281520192019301929062001279565b634e487b7160e01b88526021600452602488fd5b634e487b7160e01b600052604160045260246000fd5b634e487b7160e01b83526041600452602483fd5b634e487b7160e01b83526021600452602483fd5b5034620004e8576020366003190112620004e857600435600d54811015620004e457600d6000527fd7b6990105719101dabeb77144f2a3385c8033acd3af97e9423a695e81ad1eb501546040516001600160a01b039091168152602090f35b5034620004e85760209081600319360112620004e8576001600160a01b03620015ef83826200159662003fd1565b1692838552600c8252620015b060408620541515620042c5565b838552600c8252604080862060015491516324c697cb60e11b8152600481019190915291166001600160a01b0316602482015291829081906044820190565b038173b517944479e3e85ec1d26f607db9193706733d305af49283156200168457926200164f575b507f9e0b21701a3582ca92bc583a213ae168fa62a833e1dff10d65717c05a202725e60408051848152600586820152a2604051908152f35b9091508281813d83116200167c575b6200166a818362003ebb565b81010312620008865751903862001617565b503d6200165e565b604051903d90823e3d90fd5b5034620004e8576060366003190112620004e857620016ae62003fd1565b9060248035926044356001600160401b038111620019aa57620016d690369060040162003fe8565b600154604051630ddd3b3160e21b8152336004820152929660209490936001600160a01b0392869082908990829087165afa908115620004d5579062001724918991620004a1575062004215565b1693848652600c84526200173e60408720541515620042c5565b848652600c8452604086209060ff600d83015460a01c16600981101562001997578062001775911590811562000482575062004661565b600e820191620017eb6004620017a8620017b762001794898862004703565b506040519283918c83019586910162004741565b03601f19810183528262003ebb565b5190208a8a620017e18a60405180938b8383019687378b8201908382015203808452018262003ebb565b51902014620047cc565b82546000199390848101908111620019845762001809908262004703565b5062001816878362004703565b62001971578181036200190e575b505080548015620018fb578401906200183e828262004703565b620018e65790600060068382600b97969555826001820155826002820155826003820155620018706004820162004339565b6200187e6005820162004339565b01555501908154928301928311620018d45750917fdac7748a99ba25d9c2021272d8a96a40eeef70c99a8b0371a2d84712adc49e62959697916200043f9355604080519586958652850152604084019162004720565b634e487b7160e01b8852601160045287fd5b84634e487b7160e01b60005260006004526000fd5b634e487b7160e01b8a526031600452838afd5b600660ff818462001969955485556001810154600186015560028101546002860155600381015460038601556200194c600482016004870162004823565b6200195e600582016005870162004823565b015416910162004444565b388062001824565b634e487b7160e01b8b5260048b9052848bfd5b634e487b7160e01b8a526011600452838afd5b50634e487b7160e01b8752602160045286fd5b8380fd5b5034620004e8576020366003190112620004e8576001600160a01b0380620019d562003fd1565b1690818352600c602052620019f060408420541515620042c5565b818352600c60205282604081209173b517944479e3e85ec1d26f607db9193706733d30906001541690803b156200062d57604051636ac77ebf60e11b8152600481018590526001600160a01b039290921660248301528290829060449082905af4801562001ab25762001a9a575b5050602060ff600d7f52ab8c7f7a3fa516caf660a33a7b7a6ac1a418271b69b3b1bd57b97c37e22cb193015460a81c166040519015158152a280f35b62001aa59062003e8a565b6200062d57823862001a5e565b6040513d84823e3d90fd5b5034620004e8576060366003190112620004e8576001600160401b0390600435828111620004e45762001af590369060040162004034565b6024358381116200062d5762001b1090369060040162004034565b906044359060018060a01b038060015416956040518097630ddd3b3160e21b825233600483015281602460209a8b935afa90811562000ac3579062001b5d91889162001cc1575062004215565b62001b6a84151562004259565b604051906112ef8083019182118383101762001cad57829162001bd79162004cd18439847f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4816815260608a82015262001bc7606082018762003f8f565b9060408183039101528762003f8f565b039086f0801562000d3b571693600d54600160401b81101562001c99579262001c8862001c7a936001600c60408a999662001c3e8b62000bcf8c877fd81bf987801128d3151aa0a1f9be2b84b0b24601e400c58717bdf988158dcf629e01600d5562004113565b8a8152828d5220858155600d81018a6bffffffffffffffffffffffff60a01b825416179055015560405194859460608652606086019062003f8f565b908482038a86015262003f8f565b9060408301520390a2604051908152f35b634e487b7160e01b82526041600452602482fd5b634e487b7160e01b88526041600452602488fd5b620004c69150893d8b11620004cd57620004bd818362003ebb565b5034620004e85760209081600319360112620004e85762001cfc62003fd1565b600154604051630ddd3b3160e21b81523360048201526001600160a01b03929185908290602490829087165afa90811562000894579062001d4591859162001dba575062004215565b16808252600c835262001d5e60408320541515620042c5565b808252600c8352600d60408320019283549360ff8560a01c1694600986101562000af65762001da060008051602062005fc08339815191529495961562004661565b60ff60a01b1916600160a01b17905560405160018152a280f35b620004c69150863d8811620004cd57620004bd818362003ebb565b5034620004e8576020366003190112620004e8576001600160a01b0362001dfb62003fd1565b16808252600c60205262001e1560408320541515620042c5565b8152600c602052604081208173b517944479e3e85ec1d26f607db9193706733d3091823b15620004e45760246040518094819363192b847760e01b835260048301525af4801562001ab25762001e69575080f35b62001e749062003e8a565b80f35b5034620004e8576040366003190112620004e85762001e9562003fd1565b60243562001ea262004953565b6001600160a01b03918216808452600c602052604084205490929062001eca901515620042c5565b8060015416330362001f58577fce0de3168916a71fc175ce3a005fafab3d9ffc19f20385e575c795e275e00bc5916006602092858752600c845262001f3a836040892092309033907f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4816620049aa565b0162001f488282546200424b565b9055604051908152a26001815580f35b60405162461bcd60e51b81526020600482015260066024820152653430333a435360d01b6044820152606490fd5b5034620004e8576020366003190112620004e8576001600160a01b0362001fac62003fd1565b168152600c6020526040902080549060018101549060028101546003820154600483015460058401546006850154600786015490600887015492600988015494600a89015496600b8a015498600c8b01549a600d01549b604051809e81526020015260408d015260608c015260808b015260a08a015260c089015260e0880152610100870152610120860152610140850152610160840152610180830152600160a01b6001900381166101a08301526101c082018160a01c60ff16906200207391620040ef565b60a81c60ff1615156101e082015261020090f35b5034620004e857602080600319360112620004e457620020a662003fd1565b90620020b162004953565b600154604051630ddd3b3160e21b81523360048201526001600160a01b03939183908290602490829088165afa801562000d3b57620020f8918691620022a7575062004215565b82811692838552600c83526200211460408620541515620042c5565b838552600c83526040852092600d84019260ff845460a01c166009811015620014b75760049392916200214e600562002154931462004661565b62004bbf565b929189600889979397019182548082106000146200229e5750955b8481600154166040519586809263011a412160e61b82525afa90811562001ab2577f0e57f8ca3155b8c5071ac6070c93859eb05a8d9a167296f44dba4bd14079d2169a60809a620021f98a8095600595620022489a6200223c999262002268575b507f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb481662004c7e565b600682016200220a85825462004653565b9055805460ff60a01b1916600360a11b17905501805460095491949162002232919062004653565b6009555462004653565b8091556009546200424b565b600955604051938452830152604082015260066060820152a26001815580f35b6200228e9192508c8d3d1062002296575b62002285818362003ebb565b81019062004802565b9038620021d0565b503d62002279565b9050956200216f565b620004c69150843d8611620004cd57620004bd818362003ebb565b5034620004e8576040366003190112620004e857620022e062003fd1565b6024359081151590818303620019aa57600154604051632c9556a560e11b81523360048201529260209290916001600160a01b039084908690602490829085165afa91821562000ac35762002363620023a8937fe8b41617589ff7cce1139d64a930d2f970b9c6e0a51da359d66de455fa1ce9db978a91620023b257506200428f565b1694858752600c84526200237d60408820541515620042c5565b858752600c845260408720600d01805460ff60a81b191691151560a81b60ff60a81b16919091179055565b604051908152a280f35b62000d349150873d8911620004cd57620004bd818362003ebb565b5034620004e8576040366003190112620004e857620023eb62003fd1565b6001600160a01b039081168252600f6020526040822080546024359190821015620019aa57906200241c91620040d2565b5080546001909101546040805192835292166001600160a01b03166020820152f35b0390f35b5034620004e8576020366003190112620004e8576060620024666200214e62003fd1565b9060405192835260208301526040820152f35b5034620004e85780600319360112620004e8576040518091600d549081835260208093018092600d83527fd7b6990105719101dabeb77144f2a3385c8033acd3af97e9423a695e81ad1eb590835b818110620025295750505084620024e091038562003ebb565b60405193838594850191818652518092526040850193925b8281106200250857505050500390f35b83516001600160a01b031685528695509381019392810192600101620024f8565b82546001600160a01b031684529286019260019283019201620024c7565b5034620004e85760a0366003190112620004e8576200256562003fd1565b90602435916044356001600160401b0381116200062d576200258c90369060040162003fe8565b91909360643560843560018060a01b038060015416946040518096630ddd3b3160e21b82523360048301528160246020998a935afa9081156200273e5790620025dd918a9162002723575062004215565b1694858752600c8552620025f760408820541515620042c5565b858752600c8552604087208315620026f5578215620026c75797620026b6918360016200264b88600e7fb9cc3d6efce78bb6174ce8cad53c412cf3fc2b4b1738f4c015c74eab6223ead79c9d9e0162004703565b50620026968d6040518c8101906200266c81620017a8846004890162004741565b519020908c620017e16040519182818101948b8d87378b8201908382015203808452018262003ebb565b876003820155015560806040519788978852870152608086019162004720565b91604084015260608301520390a280f35b60405162461bcd60e51b81526004810187905260066024820152651a18181d212b60d11b6044820152606490fd5b60405162461bcd60e51b81526004810187905260066024820152651a18181d29ab60d11b6044820152606490fd5b620004c69150883d8a11620004cd57620004bd818362003ebb565b6040513d8b823e3d90fd5b5034620004e85760a0366003190112620004e8576200276762003fd1565b6024356044356064356084359160018060a01b038060015416956040518097630ddd3b3160e21b825233600483015281602460209a8b935afa80156200273e57620027ba918a9162001cc1575062004215565b1694858752600c8152620027d460408820541515620042c5565b858752600c81526040872060ff600d82015460a01c166009811015620028ea57600262002802911462004661565b80548610620028bc579185939185600460809795620028447f75c6fee771257d0c8f6faeed1a52849bd77886e7277a92a19ced50872a4d1dae9a861162004697565b6201518062002854898762004653565b048380821015620028a45762002871620028799260019262004653565b1115620046cd565b876001820155846002820155856003820155015560405194855284015260408301526060820152a280f35b62002871600191620028b69362004653565b62002879565b60405162461bcd60e51b81526004810183905260066024820152650d0c0c0e951160d21b6044820152606490fd5b634e487b7160e01b89526021600452602489fd5b5034620004e8576020366003190112620004e8576024600435602060018060a01b0360015416604051938480926373561c3b60e01b82523360048301525afa908115620029b2576200297c6020927fa8f4f21b587a66a2ee5ea394d96ed718e67720a7ff387be57edf47ee591c8faf94869162002997575062004173565b62002989811515620041df565b80600855604051908152a180f35b6200061b9150843d8111620004cd57620004bd818362003ebb565b6040513d85823e3d90fd5b5034620004e8576020366003190112620004e85760043590600e54821015620004e857600e905260011b7fbb7b4a454dc3493923482f07822329ed19e8244eff582cc204f8554c3620c3fd8101547fbb7b4a454dc3493923482f07822329ed19e8244eff582cc204f8554c3620c3fe90910154604080519283526001600160a01b03909116602083015290f35b5034620004e85780600319360112620004e8576020600854604051908152f35b5034620004e85760209081600319360112620004e85762002ad7826001600160a01b038062002a9862003fd1565b168452600c82526040808520600154915163b762faf560e01b8152600481019190915291166001600160a01b0316602482015291829081906044820190565b038173b517944479e3e85ec1d26f607db9193706733d305af49182156200168457809262002b0a575b5050604051908152f35b9091508282813d831162002b38575b62002b25818362003ebb565b81010312620004e8575051388062002b00565b503d62002b19565b5034620004e8576020366003190112620004e8576024600435602060018060a01b0360015416604051938480926373561c3b60e01b82523360048301525afa908115620029b25762002bbe6020927fda21b88dc331c96abf528dfef6a6a49a7c48ce61e82e4ab2fe8a64c01f9ee69794869162002997575062004173565b62002bcd6127108210620041a9565b80600355604051908152a180f35b5034620004e85780600319360112620004e8576020600a54604051908152f35b5034620004e85780600319360112620004e8576020600754604051908152f35b5034620004e85780600319360112620004e8576020600454604051908152f35b5034620004e8576040366003190112620004e85762002c5962003fd1565b6024359062002c6762004953565b6001600160a01b0316808352600c6020908152604084205462002c8c901515620042c5565b600854831062002d5a57818452600c81526040842062002caf84303386620049aa565b828552600f8252604085206040519062002cc98262003e6e565b8582523384830152805490600160401b82101562001cad578162002cf891600162002cff9594018155620040d2565b9062004909565b600a81018054906001820180921162000a4d57916009917f010c27d0c99728cd960c5b722003b7f1ffb3d2e930af4f84b0d67e3980207a1a9493550162002d488582546200424b565b90556040519384523393a36001815580f35b6064906040519062461bcd60e51b8252600482015260066024820152653430303a574160d01b6044820152fd5b5034620004e857602080600319360112620004e45762002da662003fd1565b600154604051630ddd3b3160e21b81523360048201526001600160a01b03929184908290602490829087165afa801562000d3b5762002ded91869162002ebb575062004215565b1690818352600c815262002e0760408420541515620042c5565b818352600c81526040832090600d8201805460ff8160a01c16600981101562002ea757927f1abd385578bb3adc021fd23b32b866f102cf1bd085b7d3d6dfe15f336d68e79d9492879262002e6060076040971462004661565b83600860028701968288549862002e798a151562004697565b89835581600184015555826003820155826007820155015561ffff60a01b191690558351928352820152a280f35b634e487b7160e01b87526021600452602487fd5b620004c69150853d8711620004cd57620004bd818362003ebb565b5034620004e8576040366003190112620004e85762002ef462003fd1565b602480359162002f0362004953565b60018054604051630ddd3b3160e21b815233600482015291946001600160a01b03936020939192849083908890829089165afa918215620004d557859262002f53918a9162001dba575062004215565b1693848752600c835262002f6d60408820541515620042c5565b848752600c835260408720600d81019460ff865460a01c16916009928381101562003278578962002f9f911462004661565b6005810190815415806200320b575b620031df5790600691600b96875490808210600014620031d457509291925b910190805b6200302257505050505050541562002fed575b505050815580f35b815460ff60a01b1916600160a11b179091556040516002815260008051602062005fc08339815191529190a238808062002fe5565b8654600019908181019081116200315757918b916200309a8f8f95906200304a8e9262004081565b509586546200305d600a91825462004653565b905586549787018054604051636e553f6560e01b8152600481019a909a528c166001600160a01b031660248a015297938492839182906044820190565b03925af1908115620031c6578c9162003193575b5050620030be835487546200424b565b8655620030ce835489546200424b565b8855620030de835486546200424b565b8555600e805480156200317e57820190620030fd620009cb8362004081565b5589548181019081116200316a578a5581019081116200315757908b7f2cafaae37c2ab1f0e3f264b9a50cad356ccf3bec7627998815a33e2b7e649a538b889796959497889554169354604051908152a390919262002fd2565b634e487b7160e01b8e526011600452878efd5b50634e487b7160e01b8f526011600452888ffd5b5050634e487b7160e01b8f526031600452888ffd5b813d8311620031be575b620031a9818362003ebb565b81010312620031ba578a38620030ae565b8e80fd5b503d6200319d565b508f604051903d90823e3d90fd5b905092919262002fcd565b60405162461bcd60e51b815260048101889052600581870152641a98181d2d60d91b6044820152606490fd5b506040516318160ddd60e01b815287816004818d5afa9081156200326d578c916200323a575b50151562002fae565b90508781813d831162003265575b62003254818362003ebb565b810103126200106657513862003231565b503d62003248565b6040513d8e823e3d90fd5b634e487b7160e01b8b526021600452848bfd5b5034620004e8576020366003190112620004e857600435801515809103620004e4576001546040516373561c3b60e01b81523360048201529190602090839060249082906001600160a01b03165afa908115620029b257620033196020927f4a9bb24c862e7e80caeeecab3b212a74be739e8e502248b17969096c2d5604bd94869162002997575062004173565b60ff196005541660ff821617600555604051908152a180f35b5034620004e8576020366003190112620004e8576024600435602060018060a01b0360015416604051938480926373561c3b60e01b82523360048301525afa908115620029b257620033b06020927ff70600f16834d4912dda5e9bdfdc5cce5d2601cf8ce7336ec725056128187c3294869162002997575062004173565b620033bf6127108210620041a9565b80600455604051908152a180f35b5034620004e85780600319360112620004e8576040517f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb486001600160a01b03168152602090f35b5034620004e85780600319360112620004e8576020600354604051908152f35b5034620004e85780600319360112620004e8576001546040516001600160a01b039091168152602090f35b5034620004e857602080600319360112620004e45760043560248260018060a01b036001541660405192838092630ddd3b3160e21b82523360048301525afa80156200089457620034b8918591620022a7575062004215565b80620034ca600a54600954906200424b565b11620035015790817ff3e93c6da78a6e8e01e84c8fcbc76f406b5e9bc011f346f88ac8afc92be8363f92600655604051908152a180f35b60405162461bcd60e51b815260048101839052600c60248201526b0d0c0c0e951bdbd4db585b1b60a21b6044820152606490fd5b5034620004e8576080366003190112620004e8576200355362003fd1565b6001600160401b0390604435828111620019aa576200357790369060040162003fe8565b9091606435848111620010bc576200359490369060040162004034565b6001546040516373561c3b60e01b81523360048201526001600160a01b039692939187169291602082602481875afa9182156200273e578892620035e0918b9162003895575062004173565b1695868852600c602052620035fb60408920541515620042c5565b868852600c6020526040882060ff600d82015460a01c166009811015620038815790620036378262003644931590811562000482575062004661565b600e602435910162004703565b509060405193620036a4602086018662003662826004880162004741565b039662003678601f199889810183528262003ebb565b519020898c620017e160208c604051938185928484019788378201908382015203808452018262003ebb565b60206040518092635ab8b6bb60e11b82528260048301528180620036cc602482018c62003f8f565b03915afa908115620010b1578a916200385d575b5016156200382f5760050191835191821162001cad576200370e8262003707855462003e31565b85620043fa565b602090601f8311600114620037a2575091817f2eb6cf0b30290a915c9f8b78a203ca54af121367170478efd2c55b4686365692969594926200043f948a9162003796575b508160011b916000199060031b1c19161790555b62003787604051948594602435865260606020870152606086019162004720565b90838203604085015262003f8f565b90508301513862003752565b8216908389526020892091895b818110620038165750926200043f9492600192827f2eb6cf0b30290a915c9f8b78a203ca54af121367170478efd2c55b46863656929a99989610620037fc575b5050811b01905562003766565b85015160001960f88460031b161c191690553880620037ef565b9192602060018192868a015181550194019201620037af565b60405162461bcd60e51b81526020600482015260066024820152651a18181d27a960d11b6044820152606490fd5b6200387a915060203d602011620022965762002285818362003ebb565b38620036e0565b634e487b7160e01b8a52602160045260248afd5b6200061b915060203d602011620004cd57620004bd818362003ebb565b5034620004e85780600319360112620004e8576020600654604051908152f35b5034620004e8576020366003190112620004e8576024600435602060018060a01b0360015416604051938480926373561c3b60e01b82523360048301525afa908115620029b257620039506020927fb443c8bd39a1b60d415144f9148c6f90c2b68a553eb90c62cef5e44979db009d94869162002997575062004173565b6200395d811515620041df565b80600755604051908152a180f35b5034620004e857602080600319360112620004e457600435906200398e62004953565b60ff600554161562003b0b57600754821062003ade57600b546001810180911162003aca57600b55620039d6620039c883600a546200424b565b80600a55600954906200424b565b6006541062003a995762003a168230337f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb486001600160a01b0316620049aa565b60405162003a248162003e6e565b8281523382820152600e54600160401b81101562003a85577f39b741a94a004f4e0edfdc3c607302b8ccb1b8c4c5a9b5f761fec94a116921fb929162002cf882600162003a759401600e5562004081565b6040519283523392a26001815580f35b634e487b7160e01b85526041600452602485fd5b6064906040519062461bcd60e51b82526004820152600a6024820152693530303a546f6f42696760b01b6044820152fd5b634e487b7160e01b84526011600452602484fd5b6064906040519062461bcd60e51b8252600482015260066024820152653430303a444160d01b6044820152fd5b6064906040519062461bcd60e51b82526004820152600b60248201526a1a98181d2737ba27b832b760a91b6044820152fd5b5034620004e8576060366003190112620004e85762003b5b62003fd1565b6001600160a01b0360243581811692838203620004e0576044359162003b8062004953565b83600154169360405192630ddd3b3160e21b845233600485015260209384816024818a5afa80156200273e5760249262003bc5859288948d9162002ebb575062004215565b1696878a52600c825262003bdf60408b20541515620042c5565b604051928380926361fbff1160e11b82528b60048301525afa908115620004d557889162003d1c575b501562003ce657848752600c8352604087209160068301918254861162003cb457859360039362003c837f670c6d2cbe2ae11af0c85d75a02c9bab189955b99625cd49da5666e7a28fc5c39860409895600d957f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb481662004c7e565b62003c9086825462004653565b905501805460ff60a01b191660a084901b1790558351928352820152a36001815580f35b60405162461bcd60e51b815260048101869052600a6024820152693430303a546f6f42696760b01b6044820152606490fd5b60405162461bcd60e51b815260048101849052600e60248201526d0d0c0c0e939bdd105b1b1bddd95960921b6044820152606490fd5b62003d379150843d8611620004cd57620004bd818362003ebb565b3862003c08565b8234620004e85780600319360112620004e8578060025462003d608162003e31565b8085529160019180831690811562003e04575060011462003da4575b6200243e8562003d8f8187038262003ebb565b60405191829160208352602083019062003f8f565b9250600283527f405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5ace5b82841062003deb57505050810160200162003d8f826200243e62003d7c565b8054602085870181019190915290930192810162003dcc565b8695506200243e9693506020925062003d8f94915060ff191682840152151560051b820101929362003d7c565b90600182811c9216801562003e63575b602083101462003e4d57565b634e487b7160e01b600052602260045260246000fd5b91607f169162003e41565b604081019081106001600160401b03821117620014cb57604052565b6001600160401b038111620014cb57604052565b61022081019081106001600160401b03821117620014cb57604052565b90601f801991011681019081106001600160401b03821117620014cb57604052565b906040519182600082549262003ef38462003e31565b90818452600194858116908160001462003f6a575060011462003f23575b505062003f219250038362003ebb565b565b9093915060005260209081600020936000915b81831062003f5157505062003f219350820101388062003f11565b8554888401850152948501948794509183019162003f36565b91505062003f2194506020925060ff191682840152151560051b820101388062003f11565b919082519283825260005b84811062003fbc575050826000602080949584010152601f8019910116010190565b60208183018101518483018201520162003f9a565b600435906001600160a01b03821682036200088657565b9181601f8401121562000886578235916001600160401b0383116200088657602083818601950101116200088657565b6001600160401b038111620014cb57601f01601f191660200190565b81601f8201121562000886578035906200404e8262004018565b926200405e604051948562003ebb565b828452602083830101116200088657816000926020809301838601378301015290565b600e54811015620040bc57600e60005260011b7fbb7b4a454dc3493923482f07822329ed19e8244eff582cc204f8554c3620c3fd0190600090565b634e487b7160e01b600052603260045260246000fd5b8054821015620040bc5760005260206000209060011b0190600090565b906009821015620040fd5752565b634e487b7160e01b600052602160045260246000fd5b600d54811015620040bc57600d6000527fd7b6990105719101dabeb77144f2a3385c8033acd3af97e9423a695e81ad1eb50190600090565b906002821015620040fd5752565b908160209103126200088657518015158103620008865790565b156200417b57565b60405162461bcd60e51b81526020600482015260066024820152653430333a4f4160d01b6044820152606490fd5b15620041b157565b60405162461bcd60e51b81526020600482015260066024820152651a18181d24a160d11b6044820152606490fd5b15620041e757565b60405162461bcd60e51b81526020600482015260066024820152653430303a495560d01b6044820152606490fd5b156200421d57565b60405162461bcd60e51b81526020600482015260066024820152653430333a544160d01b6044820152606490fd5b9190820180921162000cef57565b156200426157565b60405162461bcd60e51b81526020600482015260066024820152653430303a565360d01b6044820152606490fd5b156200429757565b60405162461bcd60e51b81526020600482015260066024820152653430333a444160d01b6044820152606490fd5b15620042cd57565b60405162461bcd60e51b81526020600482015260066024820152653430303a564160d01b6044820152606490fd5b906009811015620040fd57815460ff60a01b191660a09190911b60ff60a01b16179055565b8181106200432c575050565b6000815560010162004320565b62004345815462003e31565b908162004350575050565b81601f6000931160011462004363575055565b818352602083206200438191601f0160051c81019060010162004320565b8160208120915555565b6006600091828155826001820155826002820155826003820155620043b36004820162004339565b620043c16005820162004339565b0155565b903590601e19813603018212156200088657018035906001600160401b03821162000886576020019181360383136200088657565b9190601f81116200440a57505050565b62003f21926000526020600020906020601f840160051c8301931062004439575b601f0160051c019062004320565b90915081906200442b565b906002811015620040fd5760ff80198354169116179055565b9190918235815560209260018482013581840155604082013560028401556060820135600384015560048301620044986080840184620043c5565b6001600160401b039291838211620014cb578190620044c482620044bd865462003e31565b86620043fa565b600090601f8311600114620045ef57600092620045e3575b5050600019600383901b1c191690841b1790555b60058401916200450460a0850185620043c5565b928311620014cb576200451d83620044bd865462003e31565b600097601f8411600114620045775750829160c096979883926000946200456b575b50501b916000199060031b1c19161790555b013560028110156200088657600662003f21920162004444565b0135925038806200453f565b90601f939293198316988581528281209281905b8b8210620045cb5750508360c098999a10620045b0575b505050811b01905562004551565b0135600019600384901b60f8161c19169055388080620045a2565b8087849682949587013581550195019201906200458b565b013590503880620044dc565b8482528a822087945091601f198416815b8d8282106200463c575050841162004621575b505050811b019055620044f0565b0135600019600384901b60f8161c1916905538808062004613565b8385013586558a9790950194928301920162004600565b9190820391821162000cef57565b156200466957565b60405162461bcd60e51b81526020600482015260066024820152653530303a575360d01b6044820152606490fd5b156200469f57565b60405162461bcd60e51b81526020600482015260066024820152653430303a544560d01b6044820152606490fd5b15620046d557565b60405162461bcd60e51b81526020600482015260066024820152651a18181d2a2760d11b6044820152606490fd5b8054821015620040bc576000526007602060002091020190600090565b908060209392818452848401376000828201840152601f01601f1916010190565b600092918154620047528162003e31565b92600191808316908115620047b0575060011462004771575b50505050565b90919293945060005260209081600020906000915b8583106200479e57505050500190388080806200476b565b80548584015291830191810162004786565b60ff19168452505050811515909102019150388080806200476b565b15620047d457565b60405162461bcd60e51b81526020600482015260066024820152653430303a415360d01b6044820152606490fd5b908160209103126200088657516001600160a01b0381168103620008865790565b90808214620049055762004838815462003e31565b906001600160401b038211620014cb5781906200485b82620044bd865462003e31565b600090601f8311600114620048955760009262004889575b50508160011b916000199060031b1c1916179055565b01549050388062004873565b81526020808220858352818320935090601f1985169083905b828210620048eb575050908460019594939210620048d1575b505050811b019055565b015460001960f88460031b161c19169055388080620048c7565b8495819295850154815560018091019601940190620048ae565b5050565b906200493d57600190825181550190602060018060a01b03910151166bffffffffffffffffffffffff60a01b825416179055565b634e487b7160e01b600052600060045260246000fd5b60026000541462004965576002600055565b60405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606490fd5b6040516323b872dd60e01b60208201526001600160a01b03928316602482015292909116604483015260648083019390935291815260a08101918183106001600160401b03841117620014cb5762003f21926040525b60405162004a86916001600160a01b031662004a1c8262003e6e565b6000806020958685527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c656487860152868151910182855af13d1562004b06573d9162004a678362004018565b9262004a77604051948562003ebb565b83523d60008785013e62004b0a565b8051908162004a9457505050565b828062004aa693830101910162004159565b1562004aaf5750565b6084906040519062461bcd60e51b82526004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152fd5b6060915b9192901562004b6f575081511562004b20575090565b3b1562004b2a5790565b60405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606490fd5b82519091501562004b835750805190602001fd5b60405162461bcd60e51b81526020600482015290819062004ba990602483019062003f8f565b0390fd5b906200493d5760018160008093550155565b9060009160018060a01b03168252600c6020526040822090600354600454906040519363169fca8d60e31b855260048501526024840152604483015260608260648173b517944479e3e85ec1d26f607db9193706733d305af4918215620029b257839084809462004c32575b5050929190565b9294509250506060823d821162004c75575b8162004c536060938362003ebb565b81010312620004e8575080516020820151604090920151919290388062004c2b565b3d915062004c44565b60405163a9059cbb60e01b60208201526001600160a01b03909216602483015260448083019390935291815260808101916001600160401b03831182841017620014cb5762003f219260405262004a0056fe6080604052346200038e57620012ef803803806200001d8162000393565b9283398101906060818303126200038e5780516001600160a01b039283821692918390036200038e5760208281015190926001600160401b03918281116200038e57836200006d918301620003b9565b9260408201518381116200038e57620000879201620003b9565b82518281116200028e576003918254916001958684811c9416801562000383575b888510146200036d578190601f9485811162000317575b508890858311600114620002b057600092620002a4575b505060001982861b1c191690861b1783555b80519384116200028e5760049586548681811c9116801562000283575b828210146200026e5783811162000223575b5080928511600114620001b55750938394918492600095620001a9575b50501b92600019911b1c19161790555b600580546001600160a01b0319808216339081179093556040519490939291167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0600080a381600654161760065533906007541617600755610ec390816200042c8239f35b01519350388062000134565b92919084601f1981168860005285600020956000905b89838310620002085750505010620001ed575b50505050811b01905562000144565b01519060f884600019921b161c1916905538808080620001de565b858701518955909701969485019488935090810190620001cb565b87600052816000208480880160051c82019284891062000264575b0160051c019087905b8281106200025757505062000117565b6000815501879062000247565b925081926200023e565b602288634e487b7160e01b6000525260246000fd5b90607f169062000105565b634e487b7160e01b600052604160045260246000fd5b015190503880620000d6565b90889350601f19831691876000528a6000209260005b8c828210620003005750508411620002e7575b505050811b018355620000e8565b015160001983881b60f8161c19169055388080620002d9565b8385015186558c97909501949384019301620002c6565b90915085600052886000208580850160051c8201928b861062000363575b918a91869594930160051c01915b82811062000353575050620000bf565b600081558594508a910162000343565b9250819262000335565b634e487b7160e01b600052602260045260246000fd5b93607f1693620000a8565b600080fd5b6040519190601f01601f191682016001600160401b038111838210176200028e57604052565b919080601f840112156200038e5782516001600160401b0381116200028e57602090620003ef601f8201601f1916830162000393565b928184528282870101116200038e5760005b8181106200041757508260009394955001015290565b85810183015184820184015282016200040156fe6040608081526004908136101561001557600080fd5b600091823560e01c806301e1d114146109bb57806306fdde03146108c757806307a2d13a146108a7578063095ea7b31461087d57806318160ddd1461085e57806323b872dd14610794578063313ce5671461077857806338d52e0f1461074f57806339509351146106ff5780636e553f651461062e57806370a08231146105f7578063715018a61461059a5780638da5cb5b1461057157806395d89b411461046d578063a457c2d7146103c9578063a9059cbb14610398578063b1a635181461036f578063c6e6f59214610348578063db006a7514610223578063dd62ed3e146101d65763f2fde38b1461010857600080fd5b346101d25760203660031901126101d257610121610a21565b9061012a610a52565b6001600160a01b03918216928315610180575050600554826bffffffffffffffffffffffff60a01b821617600555167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08380a380f35b906020608492519162461bcd60e51b8352820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152fd5b8280fd5b50503461021f578060031936011261021f57806020926101f4610a21565b6101fc610a3c565b6001600160a01b0391821683526001865283832091168252845220549051908152f35b5080fd5b5090346101d25760209283600319360112610345578235610242610a52565b61024b81610e56565b9333156102f85733835282865283832054908282106102aa575081903384528387520383832055806002540360025582519081527fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef853392a351908152f35b845162461bcd60e51b8152908101879052602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608490fd5b835162461bcd60e51b8152908101869052602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608490fd5b80fd5b509134610345576020366003190112610345575061036860209235610e83565b9051908152f35b50503461021f578160031936011261021f5760075490516001600160a01b039091168152602090f35b50503461021f578060031936011261021f576020906103c26103b8610a21565b6024359033610b05565b5160018152f35b5082346103455782600319360112610345576103e3610a21565b918360243592338152600160205281812060018060a01b038616825260205220549082821061041c576020856103c28585038733610c73565b608490602086519162461bcd60e51b8352820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152fd5b5091903461021f578160031936011261021f57805191809380549160019083821c92828516948515610567575b60209586861081146105545785895290811561053057506001146104d8575b6104d487876104ca828c0383610aaa565b51918291826109d8565b0390f35b81529295507f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b5b82841061051d57505050826104d4946104ca928201019438806104b9565b80548685018801529286019281016104ff565b60ff19168887015250505050151560051b83010192506104ca826104d438806104b9565b634e487b7160e01b845260228352602484fd5b93607f169361049a565b50503461021f578160031936011261021f5760055490516001600160a01b039091168152602090f35b83346103455780600319360112610345576105b3610a52565b600580546001600160a01b0319811690915581906001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a380f35b50503461021f57602036600319011261021f5760209181906001600160a01b0361061f610a21565b16815280845220549051908152f35b5090346101d257806003193601126101d257610648610a3c565b91610651610a52565b61065b8135610e83565b926001600160a01b03169081156106bc575060209361067c84600254610ae2565b6002558181528085528281208481540190557fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef858451868152a351908152f35b606490602084519162461bcd60e51b8352820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152fd5b50503461021f578060031936011261021f576103c2602092610748610722610a21565b338352600186528483206001600160a01b03821684528652918490205460243590610ae2565b9033610c73565b50503461021f578160031936011261021f5760065490516001600160a01b039091168152602090f35b50503461021f578160031936011261021f576020905160068152f35b5082903461021f57606036600319011261021f576107b0610a21565b6107b8610a3c565b91846044359460018060a01b0384168152600160205281812033825260205220549060001982036107f2575b6020866103c2878787610b05565b84821061081b5750918391610810602096956103c295033383610c73565b9193948193506107e4565b606490602087519162461bcd60e51b8352820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152fd5b50503461021f578160031936011261021f576020906002549051908152f35b50503461021f578060031936011261021f576020906103c261089d610a21565b6024359033610c73565b509134610345576020366003190112610345575061036860209235610e56565b5090346101d257826003193601126101d257805191836003549060019082821c9282811680156109b1575b602095868610821461099e575084885290811561097c5750600114610923575b6104d486866104ca828b0383610aaa565b929550600383527fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b5b82841061096957505050826104d4946104ca928201019438610912565b805486850188015292860192810161094c565b60ff191687860152505050151560051b83010192506104ca826104d438610912565b634e487b7160e01b845260229052602483fd5b93607f16936108f2565b50503461021f578160031936011261021f57602090610368610d75565b6020808252825181830181905290939260005b828110610a0d57505060409293506000838284010152601f8019910116010190565b8181018601518482016040015285016109eb565b600435906001600160a01b0382168203610a3757565b600080fd5b602435906001600160a01b0382168203610a3757565b6005546001600160a01b03163303610a6657565b606460405162461bcd60e51b815260206004820152602060248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152fd5b90601f8019910116810190811067ffffffffffffffff821117610acc57604052565b634e487b7160e01b600052604160045260246000fd5b91908201809211610aef57565b634e487b7160e01b600052601160045260246000fd5b6001600160a01b03908116918215610c205716918215610bcf57600082815280602052604081205491808310610b7b57604082827fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef958760209652828652038282205586815220818154019055604051908152a3565b60405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608490fd5b60405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608490fd5b6001600160a01b03908116918215610d245716918215610cd45760207f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925918360005260018252604060002085600052825280604060002055604051908152a3565b60405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b600754604051632988bb9f60e21b81523060048201526001600160a01b0391610200919082908290602490829087165afa918215610e1757600092610dbc575b5050905090565b81813d8311610e10575b610dd08183610aaa565b8101031261021f5760a0810151926101a08201519081160361021f5760096101c0820151101561021f576101e00151801515036103455750803880610db5565b503d610dc6565b6040513d6000823e3d90fd5b81810292918115918404141715610aef57565b8115610e40570490565b634e487b7160e01b600052601260045260246000fd5b6002548015610e7c57610e74610e7992610e6e610d75565b90610e23565b610e36565b90565b5050600090565b600254610e8e610d75565b9081158015610eae575b610ea957610e7490610e7993610e23565b505090565b508015610e9856fea164736f6c6343000811000a6a1f3b1dd190cbef98aa225e1538128368d4e91561cef35aaa0eacfacfafe26ea164736f6c6343000811000a