Skip to content

ethereum-lists/tokens

Repository files navigation

Background

This is a project which emerged from the ashes of MyEtherWallet/ethereum-lists after the split of MyEtherWallet and MyCrypto.

Tokens

Information related to tokens. ERC-20 compliant or compatible only, please.

Format/filename:

The tokens are described in individual, JSON-formatted files. The filename for each token file should be the ERC-55-formatted Ethereum (or other chain) address of the token contract, with a .json extension.

This web tool should help getting the checksum: https://ethsum.netlify.com

Fields:

Mandatory

  • symbol: Short ticker style symbol of token.
  • name: Longer human version of token.
  • address: Ethereum (or other chain) address of ERC-20 token, in ERC-55 mixed-case format.
  • decimals: The decimals of the token. As Number and not String.

Optional

  • logo: An optional logo of your token. Must be a square (recommended: 128x128) PNG w/ transparent background. Please compress using https://tinypng.com/
  • support: A support email, support URL, or other way people can get assistance regarding the token.
  • github: Where token or project-related code lives.
  • community: Twitter, Reddit, Slack or wherever else people hang out.
  • website: Official URL of the website.
  • address_eip1191: Ethereum (or other chain) address of ERC-20 token, in EIP-1191 mixed-case format.
  • redFlags: An array containing evidence on why the contract should be treated with caution. Example: [{"type": "suspicious","comment": "fake scam token","url": "https://some.evidence"}]

The assembled lists

This repository has the tokens as single files. This makes it easier for contributors to add new tokens, for reviewers to get a good view on the change and also makes it easier to merge in tokens from other sources. Projects will most likely want to use the assembled lists. The CI server is already building them - so you can just go to the commit-list and click on the green checkmark behind the last commit. There you see kontinuum/run - and the details link there brings to the assembled files on IPFS.

Usages

Maintainers

A last note

This list is maintained by volunteers in the community & people like you around the internet. It may not always be up to date, and it may occasionally get it wrong. If you find an error or omission, please open an issue or make a PR with any corrections.