GNSBorrowingFees
Facet #9: Borrowing Fees and open interests
constructor
constructor() public
setBorrowingPairParams
function setBorrowingPairParams(uint8 _collateralIndex, uint16 _pairIndex, struct IBorrowingFees.BorrowingPairParams _value) external
Updates borrowing pair params of a pair
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
setBorrowingPairParamsArray
function setBorrowingPairParamsArray(uint8 _collateralIndex, uint16[] _indices, struct IBorrowingFees.BorrowingPairParams[] _values) external
Updates borrowing pair params of multiple pairs
Parameters
_collateralIndex
uint8
index of the collateral
_indices
uint16[]
indices of the pairs
setBorrowingGroupParams
function setBorrowingGroupParams(uint8 _collateralIndex, uint16 _groupIndex, struct IBorrowingFees.BorrowingGroupParams _value) external
Updates borrowing group params of a group
Parameters
_collateralIndex
uint8
index of the collateral
_groupIndex
uint16
index of the borrowing group
setBorrowingGroupParamsArray
function setBorrowingGroupParamsArray(uint8 _collateralIndex, uint16[] _indices, struct IBorrowingFees.BorrowingGroupParams[] _values) external
Updates borrowing group params of multiple groups
Parameters
_collateralIndex
uint8
index of the collateral
_indices
uint16[]
indices of the groups
handleTradeBorrowingCallback
function handleTradeBorrowingCallback(uint8 _collateralIndex, address _trader, uint16 _pairIndex, uint32 _index, uint256 _positionSizeCollateral, bool _open, bool _long) external virtual
Callback after a trade is opened/closed to store pending borrowing fees and adjust open interests
Parameters
_collateralIndex
uint8
index of the collateral
_trader
address
address of the trader
_pairIndex
uint16
index of the pair
_index
uint32
index of the trade
_positionSizeCollateral
uint256
position size of the trade in collateral tokens
_open
bool
true if trade has been opened, false if trade has been closed
_long
bool
true if trade is long, false if trade is short
resetTradeBorrowingFees
function resetTradeBorrowingFees(uint8 _collateralIndex, address _trader, uint16 _pairIndex, uint32 _index, bool _long) external virtual
Resets a trade borrowing fee to 0 (useful when new trade opened or when partial trade executed)
Parameters
_collateralIndex
uint8
index of the collateral
_trader
address
address of the trader
_pairIndex
uint16
index of the pair
_index
uint32
index of the trade
_long
bool
true if trade is long, false if trade is short
getBorrowingPairPendingAccFees
function getBorrowingPairPendingAccFees(uint8 _collateralIndex, uint16 _pairIndex, uint256 _currentBlock) public view returns (uint64 accFeeLong, uint64 accFeeShort, uint64 pairAccFeeDelta)
Returns the pending acc borrowing fees for a pair on both sides
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
_currentBlock
uint256
current block number
Return Values
accFeeLong
uint64
new pair acc borrowing fee on long side
accFeeShort
uint64
new pair acc borrowing fee on short side
pairAccFeeDelta
uint64
pair acc borrowing fee delta (for side that changed)
getBorrowingGroupPendingAccFees
function getBorrowingGroupPendingAccFees(uint8 _collateralIndex, uint16 _groupIndex, uint256 _currentBlock) public view returns (uint64 accFeeLong, uint64 accFeeShort, uint64 groupAccFeeDelta)
Returns the pending acc borrowing fees for a borrowing group on both sides
Parameters
_collateralIndex
uint8
index of the collateral
_groupIndex
uint16
index of the borrowing group
_currentBlock
uint256
current block number
Return Values
accFeeLong
uint64
new group acc borrowing fee on long side
accFeeShort
uint64
new group acc borrowing fee on short side
groupAccFeeDelta
uint64
group acc borrowing fee delta (for side that changed)
getTradeBorrowingFee
function getTradeBorrowingFee(struct IBorrowingFees.BorrowingFeeInput _input) public view returns (uint256 feeAmountCollateral)
Returns the borrowing fee for a trade
Parameters
_input
input data (collateralIndex, trader, pairIndex, index, long, collateral, leverage)
Return Values
feeAmountCollateral
uint256
borrowing fee (collateral precision)
getTradeLiquidationPrice
function getTradeLiquidationPrice(struct IBorrowingFees.LiqPriceInput _input) external view returns (uint256)
Returns the liquidation price for a trade
Parameters
_input
input data (collateralIndex, trader, pairIndex, index, openPrice, long, collateral, leverage)
getPairOisCollateral
function getPairOisCollateral(uint8 _collateralIndex, uint16 _pairIndex) public view returns (uint256 longOi, uint256 shortOi)
Returns the open interests for a pair
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
Return Values
longOi
uint256
open interest on long side
shortOi
uint256
open interest on short side
getBorrowingPairGroupIndex
function getBorrowingPairGroupIndex(uint8 _collateralIndex, uint16 _pairIndex) public view returns (uint16 groupIndex)
Returns the borrowing group index for a pair
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
Return Values
groupIndex
uint16
borrowing group index
getPairOiCollateral
function getPairOiCollateral(uint8 _collateralIndex, uint16 _pairIndex, bool _long) external view returns (uint256)
Returns the open interest in collateral tokens for a pair on one side
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
_long
bool
true if long side
withinMaxBorrowingGroupOi
function withinMaxBorrowingGroupOi(uint8 _collateralIndex, uint16 _pairIndex, bool _long, uint256 _positionSizeCollateral) external view returns (bool)
Returns whether a trade is within the max group borrowing open interest
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
_long
bool
true if long side
_positionSizeCollateral
uint256
position size of the trade in collateral tokens
getBorrowingGroup
function getBorrowingGroup(uint8 _collateralIndex, uint16 _groupIndex) external view returns (struct IBorrowingFees.BorrowingData)
Returns a borrowing group's data
Parameters
_collateralIndex
uint8
index of the collateral
_groupIndex
uint16
index of the borrowing group
getBorrowingGroupOi
function getBorrowingGroupOi(uint8 _collateralIndex, uint16 _groupIndex) external view returns (struct IBorrowingFees.OpenInterest)
Returns a borrowing group's oi data
Parameters
_collateralIndex
uint8
index of the collateral
_groupIndex
uint16
index of the borrowing group
getBorrowingPair
function getBorrowingPair(uint8 _collateralIndex, uint16 _pairIndex) external view returns (struct IBorrowingFees.BorrowingData)
Returns a borrowing pair's data
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
getBorrowingPairOi
function getBorrowingPairOi(uint8 _collateralIndex, uint16 _pairIndex) external view returns (struct IBorrowingFees.OpenInterest)
Returns a borrowing pair's oi data
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
getBorrowingPairGroups
function getBorrowingPairGroups(uint8 _collateralIndex, uint16 _pairIndex) external view returns (struct IBorrowingFees.BorrowingPairGroup[])
Returns a borrowing pair's oi data
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
getAllBorrowingPairs
function getAllBorrowingPairs(uint8 _collateralIndex) external view returns (struct IBorrowingFees.BorrowingData[], struct IBorrowingFees.OpenInterest[], struct IBorrowingFees.BorrowingPairGroup[][])
Returns all borrowing pairs' borrowing data, oi data, and pair groups data
Parameters
_collateralIndex
uint8
index of the collateral
getBorrowingGroups
function getBorrowingGroups(uint8 _collateralIndex, uint16[] _indices) external view returns (struct IBorrowingFees.BorrowingData[], struct IBorrowingFees.OpenInterest[])
Returns borrowing groups' data and oi data
Parameters
_collateralIndex
uint8
index of the collateral
_indices
uint16[]
indices of the groups
getBorrowingInitialAccFees
function getBorrowingInitialAccFees(uint8 _collateralIndex, address _trader, uint32 _index) external view returns (struct IBorrowingFees.BorrowingInitialAccFees)
Returns borrowing groups' data
Parameters
_collateralIndex
uint8
index of the collateral
_trader
address
address of trader
_index
uint32
index of trade
getPairMaxOi
function getPairMaxOi(uint8 _collateralIndex, uint16 _pairIndex) external view returns (uint256)
Returns the max open interest for a pair
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
getPairMaxOiCollateral
function getPairMaxOiCollateral(uint8 _collateralIndex, uint16 _pairIndex) external view returns (uint256)
Returns the max open interest in collateral tokens for a pair
Parameters
_collateralIndex
uint8
index of the collateral
_pairIndex
uint16
index of the pair
Last updated
Was this helpful?