Skip to content

FluidVaultT3 ​

Git Source

Inherits:Internals

Functions ​

operate ​

Performs operations on a vault position

This function allows users to modify their vault position by adjusting collateral and debt

solidity
function operate(
    uint256 nftId_,
    int256 newCol_,
    int256 newDebtToken0_,
    int256 newDebtToken1_,
    int256 debtSharesMinMax_,
    address to_
) external payable _dexFromAddress returns (uint256, int256, int256);

Parameters

NameTypeDescription
nftId_uint256The ID of the NFT representing the vault position
newCol_int256The change in collateral amount (positive for deposit, negative for withdrawal)
newDebtToken0_int256The change in debt amount for token0 (positive for borrowing, negative for repayment)
newDebtToken1_int256The change in debt amount for token1 (positive for borrowing, negative for repayment)
debtSharesMinMax_int256Min or max debt shares to burn or mint (positive for borrowing, negative for repayment)
to_addressThe address to receive withdrawn collateral or borrowed tokens (if address(0), defaults to msg.sender)

Returns

NameTypeDescription
<none>uint256nftId_ The ID of the NFT representing the updated vault position
<none>int256supplyAmt_ Final supply amount (negative if withdrawal occurred)
<none>int256borrowAmt_ Final borrow amount (negative if repayment occurred)

operatePerfect ​

Performs operations on a vault position with perfect collateral shares

This function allows users to modify their vault position by adjusting collateral and debt

solidity
function operatePerfect(
    uint256 nftId_,
    int256 newCol_,
    int256 perfectDebtShares_,
    int256 debtToken0MinMax_,
    int256 debtToken1MinMax_,
    address to_
) external payable _dexFromAddress returns (uint256, int256[] memory r_);

Parameters

NameTypeDescription
nftId_uint256The ID of the NFT representing the vault position
newCol_int256The change in collateral amount (positive for deposit, negative for withdrawal)
perfectDebtShares_int256The change in debt shares (positive for borrowing, negative for repayment)
debtToken0MinMax_int256Min or max debt amount for token0 to payback or borrow (positive for borrowing, negative for repayment)
debtToken1MinMax_int256Min or max debt amount for token1 to payback or borrow (positive for borrowing, negative for repayment)
to_addressThe address to receive withdrawn collateral or borrowed tokens (if address(0), defaults to msg.sender)

Returns

NameTypeDescription
<none>uint256nftId_ The ID of the NFT representing the updated vault position
r_int256[]int256 array of return values: 0 - col amount, will only change if user sends type(int).min 1 - final debt shares amount (can only change on max payback) 2 - token0 borrow or payback amount 3 - token1 borrow or payback amount

liquidate ​

Liquidates a vault position

This function allows users to liquidate a vault position by adjusting collateral and debt

solidity
function liquidate(
    uint256 token0DebtAmt_,
    uint256 token1DebtAmt_,
    uint256 debtSharesMin_,
    uint256 colPerUnitDebt_,
    address to_,
    bool absorb_
) external payable _dexFromAddress returns (uint256 actualDebtShares_, uint256 actualCol_);

Parameters

NameTypeDescription
token0DebtAmt_uint256The amount of debt in token0 to payback
token1DebtAmt_uint256The amount of debt in token1 to payback
debtSharesMin_uint256The minimum number of debt shares to liquidate
colPerUnitDebt_uint256The collateral amount per unit of debt shares
to_addressThe address to receive withdrawn collateral (if address(0), defaults to msg.sender)
absorb_boolWhether to liquidate absorbed liquidity as well

Returns

NameTypeDescription
actualDebtShares_uint256The actual number of debt shares liquidated
actualCol_uint256The actual amount of collateral withdrawn

liquidatePerfect ​

Liquidates a vault position with perfect collateral shares

This function allows users to liquidate a vault position by adjusting collateral and debt

solidity
function liquidatePerfect(
    uint256 debtShares_,
    uint256 token0DebtAmtPerUnitShares_,
    uint256 token1DebtAmtPerUnitShares_,
    uint256 colPerUnitDebt_,
    address to_,
    bool absorb_
)
    external
    payable
    _dexFromAddress
    returns (uint256 actualDebtShares_, uint256 token0Debt_, uint256 token1Debt_, uint256 actualCol_);

Parameters

NameTypeDescription
debtShares_uint256The amount of debt shares to liquidate
token0DebtAmtPerUnitShares_uint256The amount of debt in token0 per unit of debt shares (if sent 0 then entire payback is in token1)
token1DebtAmtPerUnitShares_uint256The amount of debt in token1 per unit of debt shares (if sent 0 then entire payback is in token0)
colPerUnitDebt_uint256The collateral amount per unit of debt shares
to_addressThe address to receive withdrawn collateral (if address(0), defaults to msg.sender)
absorb_boolWhether to liquidate absorbed liquidity as well

Returns

NameTypeDescription
actualDebtShares_uint256The actual number of debt shares liquidated
token0Debt_uint256The amount of debt in token0 that was paid back
token1Debt_uint256The amount of debt in token1 that was paid back
actualCol_uint256The actual amount of collateral withdrawn

constructor ​

solidity
constructor(ConstantViews memory constants_) Internals(constants_);

Structs ​

LiquidatePerfect ​

solidity
struct LiquidatePerfect {
    uint256 vaultVariables;
    uint256 initialEth;
}