@tonic-foundation/token-list

token-list

This is a fork of the popular @solana-labs/token-list for NEAR/Aurora.

Contents

• Usage
• Adding new token
• Modifying existing token
• Common issues
  • Automerge failure: found removed line
  • Failed to normalize: failed to parse JSON: json: unknown field
  • Duplicate token
  • Scanner/wallet hasn't updated yet
  • error validating schema: chainId: conflicting values 103 and 0
  • warning about the last element in the list
• Disclaimer

Usage

@tonic-foundation/token-list

@tonic-foundation/token-list is a package that allows application to query for list of tokens. The JSON schema for the tokens includes: chainId, address, name, decimals, symbol, logoURI (optional), tags (optional), and custom extensions metadata.

The interface is nearly identical to @solana-labs/token-list for ease of use.

Installation

npm install @tonic-foundation/token-list

yarn add @tonic-foundation/token-list

Examples

Query available tokens

new TokenListProvider().resolve().then((tokens) => {
  const tokenList = tokens.filterByNearEnv('mainnet').getList();
  console.log(tokenList);
});

Render icon for token in React

import React, { useEffect, useState } from 'react';
import { TokenListProvider, TokenInfo } from '@tonic-foundation/token-list';


export const Icon = (props: { mint: string }) => {
  const [tokenMap, setTokenMap] = useState<Map<string, TokenInfo>>(new Map());

  useEffect(() => {
    new TokenListProvider().resolve().then(tokens => {
      const tokenList = tokens.filterByNearEnv('mainnet').getList();

      setTokenMap(tokenList.reduce((map, item) => {
        map.set(item.address, item);
        return map;
      },new Map()));
    });
  }, [setTokenMap]);

  const token = tokenMap.get(props.mint);
  if (!token || !token.logoURI) return null;

  return (<img src={token.logoURI} />);