💸 TokenAmount

A transportable object for token amounts with formatting.

Usage

Add it to your project:

``console
yarn add token-amount
`

Use it:

`js
import TokenAmount from 'token-amount'

const amount = new TokenAmount('9388295879707883945', 18, { symbol: 'ANT' })

console.log(amount.format()) // '9.39 ANT'
`

API

$3

#### new TokenAmount(value, decimals, { symbol })

Instantiates a new TokenAmount with the given value and decimals. The options are optional, and can take a symbol (e.g. "ANT").

##### Parameters

- value: the amount value, as a BigInt, String, Number or BigInt-like (e.g. BN.js).
- decimals: the amount of decimals, as a BigInt, String, Number or BigInt-like (e.g. BN.js).
- symbol: the token symbol, as a String.

$3

#### TokenAmount#format(options)

Formats the token amount.

##### Parameters

- options.symbol: the token symbol, as a String. Overrides the value set in the constructor.
- options.commify: whether the formatted amount should include comma separators
- options.digits: the number of digits to display. Defaults to 2.
- options.displaySign: whether the sign (- or +) should be displayed for the amount.

#### TokenAmount#toString(options)

Alias to TokenAmount#format().

#### TokenAmount.format(amount, decimals, options)

Static equivalent of TokenAmount#format(), with the TokenAmount instance passed as a first parameter.

$3

#### TokenAmount#convert(rate, targetDecimals, options)

Converts from a rate, returning a new TokenAmount instance with the desired decimals and set options. The conversion rate is expressed as the amount of the output token obtained per unit of the input token. An example would be:

- Input token: ANT
- Output token: ETH
- Amount of ANT: 10
- Conversion rate: 0.5 ETH per ANT. (1 ANT = 0.5 ETH)
- Converted Amount = 10 \* 0.50 = 5 ETH.

##### Parameters

- rate: the rate to convert from, as a String or a Number.
- targetDecimals: the target amount of decimals for the output, as a BigInt, String, Number or BigInt-like (e.g. BN.js).
- options.symbol: the token symbol, as a String.

#### TokenAmount.convert(amount, rate, targetDecimals, options)

Static equivalent of TokenAmount#convert(), with the TokenAmount instance passed as a first parameter.

$3

#### TokenAmount#export()

Exports the object into a string that can get stored or transported.

#### TokenAmount.import()

Instantiates a new instance by importing a string generated by TokenAmount#export()`.