Underlying Tokens

Overview

It’s common to want to know what underlying tokens a BEX LP token represents. This documentation explains how to query this information directly from the BEX contract and LP tokens.

Querying the BEX contract and LP tokens

The BEX contract can provide the exact number of tokens in a pool. By querying this information and calculating your share of the pool, you can determine your underlying token balances.

Step-by-step process

Query the BEX contract for pool tokens and balances
Calculate your pool share
Calculate your underlying token balances

Pseudocode

(tokens, balances, lastChangeBlock) = vault.getPoolTokens(poolId);
yourPoolShare = lpToken.balanceOf(yourAddress) / lpToken.totalSupply();
uint256[] yourUnderlyingBalances = new uint256[](balances.length);
for (i = 0; i < balances.length; i++) {
    yourUnderlyingBalances[i] = balances[i] * yourPoolShare;
}
return (tokens, yourUnderlyingBalances);

Special considerations

Stable pools

For stable pools in BEX:

Use getActualSupply() instead of totalSupply() to get the correct pool supply

If you’ve staked your LP tokens, calculate your total LP token balance as:

myLpTokens = lpToken.balanceOf(yourAddress) + lpStakingContract.balanceOf(yourAddress);

Example: Querying BERA/HONEY pool

Let’s say you want to know your underlying BERA and HONEY balances for a BERA/HONEY pool:

Step	Action	Result
1	Query BEX	tokens = [BERA, HONEY], balances = [1000 BERA, 10000 HONEY]
2	Get LP token balance	yourLpTokens = 100
3	Get total LP supply	actualSupply = getActualSupply() = 1000
4	Calculate pool share	yourPoolShare = 100 / 1000 = 0.1 (10%)
5	Calculate underlying	yourBera = 1000 * 0.1 = 100 BERA
6	Calculate underlying	yourHoney = 10000 * 0.1 = 1000 HONEY

In this example, your 100 LP tokens represent 100 BERA and 1000 HONEY.

Overview

Getting Started

Proof of Liquidity

BEX

Bend

Overview

Querying the BEX contract and LP tokens

Step-by-step process

Pseudocode

Special considerations

Stable pools

Example: Querying BERA/HONEY pool

​Overview

​Querying the BEX contract and LP tokens

​Step-by-step process

​Pseudocode

​Special considerations

​Stable pools

​Example: Querying BERA/HONEY pool

Overview

Querying the BEX contract and LP tokens

Step-by-step process

Pseudocode

Special considerations

Stable pools

Example: Querying BERA/HONEY pool