ERC20 Token Viewer

token-viewer is a simple tool for retrieving ERC-20 token name, symbol, decimals, balance, and allowance for multiple tokens and ETH with a single rpc call.

Features

• Fetch name, symbol, decimals, user balance, spender allowance for multiple ERC-20 token and ETH with one RPC call.
• Supports custom RPC URL.

Supported Chains

We plan to support more chains.

| | Contract Address | |---------------------|------------------| | Ethereum | 0x9C11068da5E8956D14ca6f4a8c9E2b782B99fdfB | | Polygon | 0x9C11068da5E8956D14ca6f4a8c9E2b782B99fdfB | | Arbitrum | 0x9C11068da5E8956D14ca6f4a8c9E2b782B99fdfB | | Goerli | 0x9C11068da5E8956D14ca6f4a8c9E2b782B99fdfB | | Arbitrum Goerli | 0x9C11068da5E8956D14ca6f4a8c9E2b782B99fdfB | | Testnet zkEVM Mango | 0x18C2B4C4669277565b977F174796699656dE4175 | | Zksync Goerli | 0xCBde0e347b3f96fBcbD1177200C5e9B85b242afd |

Installation

To install token-viewer, run the following command in your project's root directory:

npm install --save token-viewer

Usage

See the auto-generated docs for more info on methods and parameters.

Fetch Tokens

import { getTokens } from 'token-viewer'

console.log(
  await getTokens(
    1, // Ethereum chain id
    [
      '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
      '0x6b175474e89094c44da98b954eedeac495271d0f',
      '0x2260fac5e5542a773aa44fbcfedf7c193bc2c599',
    ],
    '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B', // user
    '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2', // spender
  ),
)

[
  [
    '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
    'USD Coin',
    'USDC',
    BigNumber { _hex: '0x06', _isBigNumber: true },
    BigNumber { _hex: '0x04e0a5aa', _isBigNumber: true },
    BigNumber { _hex: '0x00', _isBigNumber: true },
    addr: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
    name: 'USD Coin',
    symbol: 'USDC',
    decimals: BigNumber { _hex: '0x06', _isBigNumber: true },
    balance: BigNumber { _hex: '0x04e0a5aa', _isBigNumber: true },
    allowance: BigNumber { _hex: '0x00', _isBigNumber: true }
  ],
  [
    '0x6B175474E89094C44Da98b954EedeAC495271d0F',
    'Dai Stablecoin',
    'DAI',
    BigNumber { _hex: '0x12', _isBigNumber: true },
    BigNumber { _hex: '0x1d500005c4010400', _isBigNumber: true },
    BigNumber { _hex: '0x00', _isBigNumber: true },
    addr: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
    name: 'Dai Stablecoin',
    symbol: 'DAI',
    decimals: BigNumber { _hex: '0x12', _isBigNumber: true },
    balance: BigNumber { _hex: '0x1d500005c4010400', _isBigNumber: true },
    allowance: BigNumber { _hex: '0x00', _isBigNumber: true }
  ],
  [
    '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599',
    'Wrapped BTC',
    'WBTC',
    BigNumber { _hex: '0x08', _isBigNumber: true },
    BigNumber { _hex: '0x00', _isBigNumber: true },
    BigNumber { _hex: '0x00', _isBigNumber: true },
    addr: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599',
    name: 'Wrapped BTC',
    symbol: 'WBTC',
    decimals: BigNumber { _hex: '0x08', _isBigNumber: true },
    balance: BigNumber { _hex: '0x00', _isBigNumber: true },
    allowance: BigNumber { _hex: '0x00', _isBigNumber: true }
  ],
  [
    '0x0000000000000000000000000000000000000000',
    'Ethereum',
    'ETH',
    BigNumber { _hex: '0x12', _isBigNumber: true },
    BigNumber { _hex: '0x0f9d5f9b8fe563f6', _isBigNumber: true },
    BigNumber { _hex: '0x00', _isBigNumber: true },
    addr: '0x0000000000000000000000000000000000000000',
    name: 'Ethereum',
    symbol: 'ETH',
    decimals: BigNumber { _hex: '0x12', _isBigNumber: true },
    balance: BigNumber { _hex: '0x0f9d5f9b8fe563f6', _isBigNumber: true },
    allowance: BigNumber { _hex: '0x00', _isBigNumber: true }
  ]
]

Author

• Clober