@0xsequence/token-directory

Public dataset of ERC20, ERC721, ERC1155 token lists across network deployments

Usage no npm install needed!

<script type="module">
  import 0xsequenceTokenDirectory from 'https://cdn.skypack.dev/@0xsequence/token-directory';
</script>

README

Sequence Token Directory

Token directory that contains a list of almost all ERC-20, ERC-721 and ERC-1155 tokens.

Token List Formats

The ERC-20 token lists present in this repository follow the Uniswap Token List Schema. The original list was populated using Coingecko's erc20 token list CoinGecko@95.1.0. Token description and links are taken from Coingecko's API.

The ERC-721 and ERC-1155 token lists present in this repository follow the Sequence Collectible List Schema. The original list was populated using Dune Analytics via the query #16838. Token description and links were taken from OpenSea's API.

Add or Update Your Token

If a token is missing entirely, or contains incorrect or missing information, please stick to the following procedure;

  1. Fork the current Token Directory repository
  2. Add your token in the tokens array in the correct file in the src/registry/ folder e.g. Registring a new ERC-721 token on Mainnet should be done by adding entry here.
  3. Open a PR comparing the main branch with your fork
  4. In the PR, add an explanation if this PR is for an existing token that needs to be updated

If the token is already part of the list, the token object in the registry will replace the existing token in the list (tokens will be matched by contract address).

Formats

Depending on the standard, your token entries should respect the following format:

ERC20

See here for examples.

{
  chainId: number,         // Chain ID 
  address: string,         // Contract address
  name: string,            // Name of token, 40 chars max
  symbol: string,          // Symbol of token, 20 chars max
  decimals: number,        // Number of decimals token uses
  logoURI: string | null,  // URI / URL for token logo 
  extensions: {
    link: string | null,        // URL of token's website
    description: string | null, // Short description of token (1000 chars max)
    ogImage: string | null      // URL of Open Graph image of token website 
}

ERC721 and ERC1155

See here for erc721 and here for erc1155 examples.

{
  chainId: number,                // Chain ID 
  address: string,                // Contract address
  name: string,                   // Name of token, 40 chars max
  standard: 'erc721' | 'erc1155', // Name of token's standard 
  symbol: string | null,          // Symbol of token, 20 chars max
  logoURI: string | null,         // URI / URL for token logo
  extensions: {
    link: string | null,        // URL of token's website
    description: string | null, // Short description of token (1000 chars max)
    ogImage: string | null      // URL of Open Graph image of token website 
}

LICENSE

MIT