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:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of the trader

Return Values:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of the trader
baseToken	address	The address of the trader's base token

Return Values:

Name	Type	Description
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:

Name	Type	Description
clearingHouseConfig	address	The address of ClearingHouseConfig

getOrderBook

  function getOrderBook(
  ) external returns (address)

Get OrderBook address

Return Values:

Name	Type	Description
orderBook	address	The address of OrderBook

getVault

  function getVault(
  ) external returns (address)

Get Vault address

Return Values:

Name	Type	Description
vault	address	The address of Vault

getBaseTokens

  function getBaseTokens(
    address trader
  ) external returns (address[])

Get trader registered baseTokens

Parameters:

Name	Type	Description
trader	address	The address of trader

Return Values:

Name	Type	Description
baseTokens	address[]	The array of baseToken address

getAccountInfo

  function getAccountInfo(
    address trader,
    address baseToken
  ) external returns (struct AccountMarket.Info)

Get trader account info

Parameters:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader

Return Values:

Name	Type	Description
totalDebtValue	uint256	The debt value of trader

getPnlAndPendingFee

  function getPnlAndPendingFee(
    address trader
  ) external returns (int256, int256, uint256)

Get owedRealizedPnl, unrealizedPnl and pending fee

Parameters:

Name	Type	Description
trader	address	The address of trader

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken
accountValue	int256	The account value of trader

Return Values:

Name	Type	Description
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:

Name	Type	Description
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader
baseToken	address	The address of baseToken

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader

Return Values:

Name	Type	Description
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:

Name	Type	Description
trader	address	The address of trader

Return Values:

Name	Type	Description
marginRequirementForLiquidation	int256	It is compared with ClearingHouse.getAccountValue which is also an int