AccountBalance
Functions
initialize
function initialize(
) external
setVault
function setVault(
) external
modifyTakerBalance
function modifyTakerBalance(
address trader,
address baseToken,
int256 base,
int256 quote
) external returns (int256, int256)
Modify trader account balance
Only used by ClearingHouse
contract
Parameters:
trader
address
The address of the trader
baseToken
address
The address of the baseToken
base
int256
Modified amount of base
quote
int256
Modified amount of quote
Return Values:
takerPositionSize
int256
Taker position size after modified
takerOpenNotional
int256
Taker open notional after modified
modifyOwedRealizedPnl
function modifyOwedRealizedPnl(
address trader,
int256 amount
) external
Modify trader owedRealizedPnl
Only used by ClearingHouse
contract
Parameters:
trader
address
The address of the trader
amount
int256
Modified amount of owedRealizedPnl
settleQuoteToOwedRealizedPnl
function settleQuoteToOwedRealizedPnl(
address trader,
address baseToken,
int256 amount
) external
Modify trader owedRealizedPnl
Only used by ClearingHouse
contract
Parameters:
trader
address
The address of the trader
baseToken
address
The address of the baseToken
amount
int256
Settled quote amount
settleOwedRealizedPnl
function settleOwedRealizedPnl(
address trader
) external returns (int256)
Settle owedRealizedPnl
Only used by Vault.withdraw()
Parameters:
trader
address
The address of the trader
Return Values:
pnl
int256
Settled owedRealizedPnl
settleBalanceAndDeregister
function settleBalanceAndDeregister(
address trader,
address baseToken,
int256 takerBase,
int256 takerQuote,
int256 realizedPnl,
int256 makerFee
) external
Settle account balance and deregister base token
Only used by ClearingHouse
contract
Parameters:
trader
address
The address of the trader
baseToken
address
The address of the baseToken
takerBase
int256
Modified amount of taker base
takerQuote
int256
Modified amount of taker quote
realizedPnl
int256
Amount of pnl realized
makerFee
int256
Amount of maker fee collected from pool
registerBaseToken
function registerBaseToken(
address trader,
address baseToken
) external
Every time a trader's position value is checked, the base token list of this trader will be traversed; thus, this list should be kept as short as possible
Only used by ClearingHouse
contract
Parameters:
trader
address
The address of the trader
baseToken
address
The address of the trader's base token
deregisterBaseToken
function deregisterBaseToken(
address trader,
address baseToken
) external
Deregister baseToken from trader accountInfo
Only used by ClearingHouse
contract, this function is expensive, due to for loop
Parameters:
trader
address
The address of the trader
baseToken
address
The address of the trader's base token
updateTwPremiumGrowthGlobal
function updateTwPremiumGrowthGlobal(
address trader,
address baseToken,
int256 lastTwPremiumGrowthGlobalX96
) external
Update trader Twap premium info
Only used by ClearingHouse
contract
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
lastTwPremiumGrowthGlobalX96
int256
The last Twap Premium
settlePositionInClosedMarket
function settlePositionInClosedMarket(
address trader,
address baseToken
) external returns (int256 positionNotional, int256 openNotional, int256 realizedPnl, uint256 closedPrice)
Settle trader's PnL in closed market
we don't do swap to get position notional here. we define the position notional in a closed market is closed price * position size
Parameters:
trader
address
The address of the trader
baseToken
address
The address of the trader's base token
Return Values:
positionNotional
int256
Taker's position notional settled with closed price
openNotional
int256
Taker's open notional
realizedPnl
int256
Settled realized pnl
closedPrice
uint256
The closed price of the closed market
getClearingHouseConfig
function getClearingHouseConfig(
) external returns (address)
Get ClearingHouseConfig
address
Return Values:
clearingHouseConfig
address
The address of ClearingHouseConfig
getOrderBook
function getOrderBook(
) external returns (address)
Get OrderBook
address
Return Values:
orderBook
address
The address of OrderBook
getVault
function getVault(
) external returns (address)
Get Vault
address
Return Values:
vault
address
The address of Vault
getBaseTokens
function getBaseTokens(
address trader
) external returns (address[])
Get trader registered baseTokens
Parameters:
trader
address
The address of trader
Return Values:
baseTokens
address[]
The array of baseToken address
getAccountInfo
function getAccountInfo(
address trader,
address baseToken
) external returns (struct AccountMarket.Info)
Get trader account info
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
Return Values:
traderAccountInfo
struct AccountMarket.Info
The baseToken account info of trader
getTakerOpenNotional
function getTakerOpenNotional(
) external returns (int256)
getTotalOpenNotional
function getTotalOpenNotional(
) external returns (int256)
getTotalDebtValue
function getTotalDebtValue(
address trader
) external returns (uint256)
Get total debt value of trader
Total debt value will relate to Vault.getFreeCollateral()
Parameters:
trader
address
The address of trader
Return Values:
totalDebtValue
uint256
The debt value of trader
getPnlAndPendingFee
function getPnlAndPendingFee(
address trader
) external returns (int256, int256, uint256)
Get owedRealizedPnl, unrealizedPnl and pending fee
Parameters:
trader
address
The address of trader
Return Values:
owedRealizedPnl
int256
the pnl realized already but stored temporarily in AccountBalance
unrealizedPnl
int256
the pnl not yet realized
pendingFee
uint256
the pending fee of maker earned
hasOrder
function hasOrder(
address trader
) external returns (bool)
Check trader has open order in open/closed market.
Parameters:
trader
address
The address of trader
Return Values:
True
bool
of false
getLiquidatablePositionSize
function getLiquidatablePositionSize(
address trader,
address baseToken,
int256 accountValue
) external returns (int256)
Get liquidatable position size of trader's baseToken market
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
accountValue
int256
The account value of trader
Return Values:
liquidatablePositionSize
int256
The liquidatable position size of trader's baseToken market
getMarkPrice
function getMarkPrice(
address baseToken
) external returns (uint256)
Get mark price of baseToken market
Mark price is the median of three prices as below.
1. current market price
2. market twap with 30 mins
3. index price + premium with 15 mins
If the parameters to calculate mark price are not set, returns index twap instead for backward compatible If the market is paused, returns index twap instead, that will be the index twap while pausing market
Parameters:
baseToken
address
The address of baseToken
Return Values:
price
uint256
The mark price of baseToken market
getBase
function getBase(
address trader,
address baseToken
) public returns (int256)
Get trader base amount
base amount = takerPositionSize - orderBaseDebt
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
Return Values:
baseAmount
int256
The base amount of trader's baseToken market
getQuote
function getQuote(
address trader,
address baseToken
) public returns (int256)
Get trader quote amount
quote amount = takerOpenNotional - orderQuoteDebt
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
Return Values:
quoteAmount
int256
The quote amount of trader's baseToken market
getTakerPositionSize
function getTakerPositionSize(
address trader,
address baseToken
) public returns (int256)
Get taker position size of trader's baseToken market
This will only has taker position, can get maker impermanent position through getTotalPositionSize
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
Return Values:
takerPositionSize
int256
The taker position size of trader's baseToken market
getTotalPositionSize
function getTotalPositionSize(
address trader,
address baseToken
) public returns (int256)
Get total position size of trader's baseToken market
total position size = taker position size + maker impermanent position size
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
Return Values:
totalPositionSize
int256
The total position size of trader's baseToken market
getTotalPositionValue
function getTotalPositionValue(
address trader,
address baseToken
) public returns (int256)
Get total position value of trader's baseToken market
A negative returned value is only be used when calculating pnl, we use mark price to calc position value
Parameters:
trader
address
The address of trader
baseToken
address
The address of baseToken
Return Values:
totalPositionValue
int256
Total position value of trader's baseToken market
getTotalAbsPositionValue
function getTotalAbsPositionValue(
address trader
) public returns (uint256)
Get all market position abs value of trader
Parameters:
trader
address
The address of trader
Return Values:
totalAbsPositionValue
uint256
Sum up positions value of every market
getMarginRequirementForLiquidation
function getMarginRequirementForLiquidation(
address trader
) public returns (int256)
Get margin requirement to check whether trader will be able to liquidate
This is different from Vault._getTotalMarginRequirement()
, which is for freeCollateral calculation
Parameters:
trader
address
The address of trader
Return Values:
marginRequirementForLiquidation
int256
It is compared with ClearingHouse.getAccountValue
which is also an int
Last updated
Was this helpful?