@0xsequence/token-directory
v1.1.14
Published
Public dataset of ERC20, ERC721, ERC1155 token lists across network deployments
Downloads
73
Keywords
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 [email protected]. 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;
- Fork the current Token Directory repository
- 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. - Open a PR comparing the main branch with your fork
- 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