ISaturationAndGeometricTWAPState

Git Source

Functions

init

initializes the sat (allocating storage for all nodes) and twap structs

function init(
    int16 firstTick
) external;

setNewPositionSaturation

function setNewPositionSaturation(address pair, uint256 maxDesiredSaturationInMAG2) external;

getLeafDetails

function getLeafDetails(
    address pairAddress,
    bool netDebtX,
    uint256 leaf
)
    external
    view
    returns (
        Saturation.SaturationPair memory saturation,
        uint256 currentPenaltyInBorrowLSharesPerSatInQ72,
        uint16[] memory tranches
    );

getTreeDetails

function getTreeDetails(address pairAddress, bool netX) external view returns (uint16, uint128);

getTrancheDetails

function getTrancheDetails(
    address pairAddress,
    bool netDebtX,
    int16 tranche
) external view returns (uint16 leaf, Saturation.SaturationPair memory saturation);

getAccount

function getAccount(
    address pairAddress,
    bool netX,
    address accountAddress
) external view returns (Saturation.Account memory);

update

update the borrow position of an account and potentially check (and revert) if the resulting sat is too high

function update(Validation.InputParams memory inputParams, address account) external;

Parameters

Name	Type	Description
inputParams	Validation.InputParams	contains the position and pair params, like account borrows/deposits, current price and active liquidity
account	address	for which is position is being updated

accruePenalties

accrue penalties since last accrual based on all over saturated positions

function accruePenalties(
    address account,
    uint256 externalLiquidity,
    uint256 duration,
    uint256 allAssetsDepositL,
    uint256 allAssetsBorrowL,
    uint256 allSharesBorrowL
) external returns (uint112 penaltyInBorrowLShares, uint112 accountPenaltyInBorrowLShares);

Parameters

Name	Type	Description
account	address
externalLiquidity	uint256	Swap liquidity outside this pool
duration	uint256	since last accrual of penalties
allAssetsDepositL	uint256	allAsset[DEPOSIT_L]
allAssetsBorrowL	uint256	allAsset[BORROW_L]
allSharesBorrowL	uint256	allShares[BORROW_L]

calcSatChangeRatioBips

Calculate the ratio by which the saturation has changed for account.

function calcSatChangeRatioBips(
    Validation.InputParams memory inputParams,
    uint256 liqSqrtPriceInXInQ72,
    uint256 liqSqrtPriceInYInQ72,
    address pairAddress,
    address account
) external view returns (uint256 ratioNetXBips, uint256 ratioNetYBips);

Parameters

Name	Type	Description
inputParams	Validation.InputParams	The params containing the position of account.
liqSqrtPriceInXInQ72	uint256	The liquidation price.
liqSqrtPriceInYInQ72	uint256
pairAddress	address	The address of the pair
account	address	The account for which we are calculating the saturation change ratio.

Returns

Name	Type	Description
ratioNetXBips	uint256	The ratio representing the change in netX saturation for account.
ratioNetYBips	uint256	The ratio representing the change in netY saturation for account.

configLongTermInterval

Configures the interval of long-term observations.

This function is used to set the long-term interval between observations for the long-term buffer.

function configLongTermInterval(address pairAddress, uint24 longTermIntervalConfigFactor) external;

Parameters

Name	Type	Description
pairAddress	address	The address of the pair for which the long-term interval is being configured.
longTermIntervalConfigFactor	uint24	The desired duration for each long-term period. The size is set as a factor of the mid-term interval to ensure a sufficient buffer, requiring at least 16 * 12 = 192 seconds per period, resulting in a total of ~25 minutes (192 * 8 = 1536 seconds) for the long-term buffer.

recordObservation

Records a new observation tick value and updates the observation data.

This function is used to record new observation data for the contract. It ensures that the provided tick value is stored appropriately in both mid-term and long-term observations, updates interval counters, and handles tick cumulative values based on the current interval configuration. Ensures that this function is called in chronological order, with increasing timestamps. Returns in case the provided block timestamp is less than or equal to the last recorded timestamp.

function recordObservation(int16 newTick, uint32 timeElapsed) external returns (bool);

Parameters

Name	Type	Description
newTick	int16	The new tick value to be recorded, representing the most recent update of reserveXAssets and reserveYAssets.
timeElapsed	uint32	The time elapsed since the last observation.

getTickRange

Gets the min and max range of tick values from the stored oracle observations.

This function calculates the minimum and maximum tick values among three observed ticks: long-term tick, mid-term tick, and current tick.

function getTickRange(address pair, int16 currentTick, bool includeLongTermTick) external view returns (int16, int16);

Parameters

Name	Type	Description
pair	address	The address of the pair for which the tick range is being queried.
currentTick	int16	The current tick value.
includeLongTermTick	bool	Boolean value indicating whether to include the long-term tick in the range.

Returns

Name	Type	Description
<none>	int16	minTick The minimum tick value among the three observed ticks.
<none>	int16	maxTick The maximum tick value among the three observed ticks.

getLendingStateTickAndCheckpoint

Gets the tick value representing the TWAP since the last lending update and checkpoints the current lending cumulative sum as self.lendingCumulativeSum and the current block timestamp as self.lastLendingTimestamp.

See getLendingStateTick for implementation details which was separated to allow view access without any state updates.

function getLendingStateTickAndCheckpoint(
    uint32 timeElapsedSinceUpdate,
    uint32 timeElapsedSinceLendingUpdate
) external returns (int16, uint256);

Parameters

Name	Type	Description
timeElapsedSinceUpdate	uint32	The time elapsed since the last price update.
timeElapsedSinceLendingUpdate	uint32	The time elapsed since the last lending update.

Returns

Name	Type	Description
<none>	int16	lendingStateTick The tick value representing the TWAP since the last lending update.
<none>	uint256

getObservedMidTermTick

Retrieves the mid-term tick value based on the stored observations.

function getObservedMidTermTick(
    bool isLongTermBufferInitialized
) external view returns (int16 midTermTick);

Parameters

Name	Type	Description
isLongTermBufferInitialized	bool	Boolean value which represents whether long-term buffer is filled or not.

Returns

Name	Type	Description
midTermTick	int16	The mid-term tick value.

boundTick

The function ensures that newTick stays within the bounds determined by lastTick and a dynamically calculated factor.

function boundTick(
    int16 newTick
) external view returns (int16);

Parameters

Name	Type	Description
newTick	int16	The proposed new tick value to be adjusted within valid bounds.

Returns

Name	Type	Description
<none>	int16	The adjusted tick value constrained within the allowable range.

getLendingStateTick

Gets the tick value representing the TWAP since the last lending update.

function getLendingStateTick(
    int56 newTick,
    uint32 timeElapsedSinceUpdate,
    uint32 timeElapsedSinceLendingUpdate
) external view returns (int16, uint256);

Parameters

Name	Type	Description
newTick	int56	The current tick value.
timeElapsedSinceUpdate	uint32	The time elapsed since the last price update.
timeElapsedSinceLendingUpdate	uint32	The time elapsed since the last lending update.

Returns

Name	Type	Description
<none>	int16	lendingStateTick The tick value representing the TWAP since the last lending update.
<none>	uint256	currentCumulativeSum The current cumulative sum for the last updated timestamp.

getObservations

function getObservations(
    address pair
) external view returns (GeometricTWAP.Observations memory);

liquidationCheckHardPremiums

function liquidationCheckHardPremiums(
    Validation.InputParams memory inputParams,
    address borrower,
    Liquidation.HardLiquidationParams memory hardLiquidationParams,
    uint256 actualRepaidLiquidityAssets
) external view returns (bool badDebt);

Errors

PairAlreadyExists

error PairAlreadyExists();

PairDoesNotExist

error PairDoesNotExist();

InvalidUserConfiguration

error InvalidUserConfiguration();