constructor(tokenAmountA: TokenAmount, tokenAmountB: TokenAmount, swapFee?: JSBI)
Copy

The Pair entity represents a Materia pair with a balance of each of its pair tokens and the defined swap fee. The BASE_FEE value (0.3%) is used if the swapFee parameter is not passed in arguments.

Example

import { ChainId, Token, TokenAmount, Pair, JSBI, IETH } from '@materia/sdk'

const BASE_FEE = JSBI.BigInt(30)
const WUSD = new Token(ChainId.MAINNET, '0x7C974104DF9dd7fb91205ab3D66d15AFf1049DE8', 18, 'WUSD', 'Wrapped USD')

const pair = new Pair(new TokenAmount(WUSD, '2000000000000000000'), new TokenAmount(IETH[WUSD.chainId], '1000000000000000000'), BASE_FEE)
Copy

Static Methods

getAddress

getAddress(tokenA: Token, tokenB: Token): string
Copy

Computes the pair address for the passed Tokens using the INIT_CODE_HASH. See Pair Addresses.

Properties

liquidityToken

liquidityToken: Token
Copy

A Token representing the liquidity token for the pair. See Pair (ERC-20).

swapFee

swapFee: JSBI
Copy

The dynamic swap fee value that can be changed though a DFO proposal.

token0

token0: Token
Copy

See token0.

token1

token1: Token
Copy

See token1.

reserve0

reserve0: TokenAmount
Copy

The reserve of token0.

reserve1

reserve1: TokenAmount
Copy

The reserve of token1.

Methods

reserveOf

reserveOf(token: Token): TokenAmount
Copy

Returns reserve0 or reserve1, depending on whether token0 or token1 is passed in.

getOutputAmount

getOutputAmount(inputAmount: TokenAmount): [TokenAmount, Pair]
Copy

Pricing function for exact input amounts. Returns maximum output amount based on current reserves and the new Pair that would exist if the trade were executed.

getInputAmount

getInputAmount(outputAmount: TokenAmount): [TokenAmount, Pair]
Copy

Pricing function for exact output amounts. Returns minimum input amount based on current reserves and the new Pair that would exist if the trade were executed.

getLiquidityMinted

getLiquidityMinted(totalSupply: TokenAmount, tokenAmountA: TokenAmount, tokenAmountB: TokenAmount): TokenAmount
Copy

Calculates the exact amount of liquidity tokens minted from a given amount of token0 and token1.

• totalSupply must be looked up on-chain.
• The value returned from this function cannot be used as an input to getLiquidityValue.

getLiquidityValue

getLiquidityValue(
  token: Token,
  totalSupply: TokenAmount,
  liquidity: TokenAmount,
  feeOn: boolean = false,
  kLast?: BigintIsh
): TokenAmount
Copy

Calculates the exact amount of token0 or token1 that the given amount of liquidity tokens represent.

• totalSupply must be looked up on-chain.
• If the protocol charge is on, feeOn must be set to true, and kLast must be provided from an on-chain lookup.
• Values returned from this function cannot be used as inputs to getLiquidityMinted.