pricing.ts

Last modified: April 16, 2026

path: /src/utils/pricing.ts

WETH_ADDRESS

Eth Mainnet

- type: string
- value: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'

Polygon

- type: string
- value: '0x7ceb23fd6bc0add59e62ac25578270cff1b9f619'

Arbitrum-One

- type: string
- value: '0x82af49447d8a07e3bd95bd0d56f35241523fbab1'

Optimism

- type: string
- value: '0x4200000000000000000000000000000000000006'

Address of wrapped-ETH (WETH) contract on ethereum mainnet.

Referenced at:

1. WHITELIST_TOKENS
2. findEthPerToken()

USDC_WETH_03_POOL

Eth Mainnet

- type: string
- value: '0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8'

Address of Centurion V3 pool contract between USDC and WETH ERC-20 tokens on the specific chain.

Referenced at:

1. getEthPriceInUSD

Polygon

- type: string
- value: '0x0e44ceb592acfc5d3f09d996302eb4c499ff8c10'

Arbitrum-One

- type: string
- value: '0x17c14d2c404d167802b16c450d3c99f88f2c4f4d'

Optimism

• Not present. Instead refer DAI_WETH_03_POOL

DAI_WETH_03_POOL

Optimism

- type: string
- value: '0x03af20bdaaffb4cc0a521796a223f7d85e2aac31'

Address of Centurion V3 pool contract between DAI and WETH ERC-20 tokens on optimsim mainnet.

Referenced at:

1. getEthPriceInUSD

Other-Chains

• Not present. Instead refer USDC_WETH_03_POOL

WHITELIST_TOKENS

A list of tokens which have considerable usage and are likely to have pool pairing with other tokens. These can be used for calculating liquidity in USD by using the tokens price in USD.

The following token addresses are present in the list:

Eth Mainnet

Dependencies:

1. WETH_ADDRESS

Referenced at:

1. getTrackedAmountUSD
2. handlePoolCreated()

Polygon

Additional Referenced at:

1. populateEmptyPools()

* -> The value is imported from a variable and listed directly in the list declaration.

STABLE_COINS

A list of ERC20 token contract addresses which have stable coin prices, i.e., 1 token expected to be valued at 1 USD. Eth Mainnet

Referenced at:

1. findEthPertoken()

Polygon

Arbitrum-One

• STABLE_COINS is not defined for arbitrum-one subgraph.

Optimism

• STABLE_COINS is not defined for optimism subgraph.

MINIMUM_ETH_LOCKED

Eth Mainnet

 - type: BigDecimal
 - value: 60

While calculating token price in USD, the value of other token locked in the pool in terms of eth has to be greated than MINIMUM_ETH_LOCKED.

Referenced at:

1. findEthPertoken()

Polygon

 - type: BigDecimal
 - value: 5

Arbitrum-One

 - type: BigDecimal
 - value: 4

Additionally Referenced at:

1. getEthPriceInUSD()

Optimism

 - type: BigDecimal
 - value: 10

sqrtPriceX96ToTokenPrices()

Params:
 - sqrtPriceX96 (BigInt): The square root of the price of token1 in terms of token0 in Q64.96 format. Formula: sqrt(token0.price/token1.price)*(2^96)
 - token0 (Token): The first token in the pool pair to calculate the relative price for
 - token1 (Token): The second token in the pool pair to calculate the relative price for
 
ReturnType: BigDecimal[]

Find the price of token0 and token1 in the pool relative to each other and returns the two prices.

Formula:

    num = (sqrtPriceX96^2) # Squaring the root to get the price
    denom = 2^192 # To divide price by 96^2 to convert the Q64.96 number to BigDecimal
    price1 = ((num/denom) * (10^token0.decimals))/ (10^token1.decimals) # Calculating price1
    price0 = 1/price1

Dependencies:

1. exponentToBigDecimal()
2. safeDiv()

Invoked at:

1. handleSwap()

getEthPriceInUSD()

Params: none
 
ReturnType: BigDecimal

Other Chains

Returns the Price of ETH in terms of USD, based on the stable coin pools. Currently, the token0Price for the pool represented by USDC_WETH_03_POOL. When pool entity is not found, returns ZERO_BD.

Entites:

1. Pool - Read Entity

Dependencies:

1. USDC_WETH_03_POOL
2. ZERO_BD

Invoked at:

1. handleInitialize()
2. handleSwap()

Arbitrum-One

• Logic same as mainnet, except returns ZERO_BD if eth locked is not greated than MINIMUM_ETH_LOCKED.

Additional Dependencies:

1. MINIMUM_ETH_LOCKED

Optimism

• Uses DAI_WETH_03_POOL instead of USDC

Differing Dependencies:

1. DAI_WETH_03_POOL

findEthPerToken()

Params:
 - token (Token): Token entity to find the price in terms of ETH
 
ReturnType: BigDecimal

Eth Mainnet, Polygon

If token is weth, returns 1. If token in STABLE_COINS, returns 1/bundle.ethPriceUSD.

Else, iterates over all the whitelisted pools for the token using token.whitelistPools. Finds the pool with largest liquidity value in terms of ETH, as long as the value is atleast MINIMUM_ETH_LOCKED. Uses the eth value of the paired token and relative token price between the token pair to find the token's' value in terms of eth. If there's no whitelisted pool with MINIMUM_ETH_LOCKED, returns ZERO_BD.

Entites:

1. Bundle - Read Entity
2. Pool - Read Entity
3. Token - Read Entity

Dependencies:

1. WETH_ADDRESS
2. ONE_BD
3. ZERO_BD
4. STABLE_COINS
5. MINIMUM_ETH_LOCKED

Invoked at:

1. handleInitialize()
2. handleSwap()

Arbitrum-One

• Doesn't check if token is present in STABLE_COINS. Rest of the logic is same as mainnet.

getTrackedAmountUSD()

Params:
 - tokenAmount0 (BigDecimal):
 - token0 (Token0):
 - tokenAmount1 (BigDecimal):
 - token1 (Token):
 
ReturnType: BigDecimal

Returns the USD value equivalent to tokenAmoun0 and tokenAmount1 together. Calculates the USD price using token.derviedEth*bundle.ethPriceUSD as the multiplier if the token is present in WHITELIST_TOKENS. If both the tokens are present, it adds their individual USD prices. If only one is present, it uses 2X the value of that token. If neither are in the WHITELIST_TOKENS list, returns ZERO_BD.

Entites:

1. Bundle - Read Entity

Dependencies:

1. WHITELIST_TOKENS
2. ZERO_BD

Invoked at:

1. handleSwap()