ethereum-lists / tokens

Ethereum token definitions

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

• WallETH
• MyCrypto
• MyEtherWallet | MEW
• TREZOR - they even import via IPFS ;-)
• Tokenstation
• pyetherbalance)
• rainbow-me/rainbow-token-list
• please let us know when you do (you don't need to but it would be nice!)

Maintainers

• 409H (409H - EtherAddressLookup)

• tayvano (tayvano - MyCrypto)

• ligi (ligi - WallETH)

• You!

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.

tokens's Issues

Inline Icons

For #117 to make sense icons must be Inlined. External url's can be changed after the fact. So download the images (and perhaps optimize/post-process them) - save with the hash as name.

Add your tokens

Merged Create 0xe6D2a9fCD946E07826C6cdd919DA04763eA4D812.json, but did not end up in the website Token lists

Hi, I am the creator of Create 0xe6D2a9fCD946E07826C6cdd919DA04763eA4D812.json. The file was merged about a week ago, but I do not see the token’s name on the list of supported tokens on Trezor’s website. When will Bruh go onto the website’s list?

Add DeFi protocol tokens to ethereum-lists repo

Add DeFi protocol related tokens (list below) this repo (https://github.com/ethereum-lists/tokens/tree/master/tokens/eth)

1. Compound - https://compound.finance/developers
2. Fulcrum - https://github.com/bZxNetwork/fulcrum_ui/blob/development/packages/mmaker-wrappers/assets/artifacts/tokenList.ts
3. Uniswap - https://github.com/Uniswap/uniswap-frontend/blob/5bcbe0ee8fb4a1524b43ab34b495773c129d4765/src/contexts/Tokens.js
4. Synthetix - https://developer.synthetix.io/api/docs/deployed-contracts.html

We are specifically looking for those found above. If you know of others and want to add those, too, that would be and awesome net-positive for the numerous wallets that use this list to populate their default tokens.

Instructions on what information is required and more information on how the repo is maintained is here: https://github.com/ethereum-lists/tokens

Don’t forget to use the mIxEd cAsE eIp55 addresses!

This is a Gitcoin Bounty issue.

Update README

we have some new fields - that should be reflected in the README

Ability to import from MEW token list

unfortunately there are now changes on 2 ends - so we need to import/merge things. Easy for additions - bit difficult for updates.
cc @kvhnuke

Please update ETHMNY logo 0xbf4a2ddaa16148a9d0fa2093ffac450adb7cd4aa

Link for logo
ETHMNY contract address:0xbf4a2ddaa16148a9d0fa2093ffac450adb7cd4aa

https://drive.google.com/file/d/12BfvXbG1-m8FpdLzD9bKS9K1cnf-GNXq/view?usp=drivesdk

[https://drive.google.com/file/d/12BfvXbG1-m8FpdLzD9bKS9K1cnf-GNXq/view?usp=drivesdk(url)

comment field

broken www link in desc

"Usage: TREZOR - they even import via IPFS ;-)" that http link is not working now

prevent trailing or leading space

prevent issues like this: #138

Remove Gradle Config

Thanks for starting up this organization! I think this is a great step forward for ensuring that a community maintained token list is kept up-to-date and available!

One issue that the team at MyCrypto is having with this (and the older) ethereum-lists is that the gradle specific configuration doesn't allow us to integrate this token list as a git submodule.

What do you think of moving the tokens directory down one level, and removing the existing gradle packaging / handling that in another layer for WALLETH?

It would certainly be really helpful for us to only have one source of truth for tokens, which hopefully this repo can become.

Let me know if there's anything I can do to help! Happy to PR the change myself, but wanted to start the discussion so that you weren't taken by surprise by such a PR.

Indicate that a token has launched a mainnet

there is currently no indication in the data that a token has launched a mainnet.

This seems to me to call for a new kind of entry in "deprecation" section, AND a new metadata entry somewhere other, because these two can be independent. Maybe there is a mainnet but the token is still tradeable? (in that case, the mainnet info is purely informative; in case of deprecation, it should mark the token as something like "do not trade")

what sort of information can we even have about a mainnet? perhaps just a boolean flag, has_mainnet?

so many questions

link token contracts

can find some here: https://github.com/nick/token-audit/tree/master/contracts

Update REP Token Contract Address -- First Week of July

Hello,

We are writing to inform you that Augur is set to be deployed on the Ethereum main network the morning of July 9th, 2018. With deployment, we also must conduct a migration of the REP token
balances, so that the new REP token exists inside the Augur genesis universe.

On July 9th, 2018 at 11:01AM PST, the current REP token contract will be frozen indefinitely. Once
this occurs, no more transfers of the tokens on the old contract will be possible. We have publicly disclosed this on Wednesday, May 16th, 2018 in our ‘Deployment Details & REP Migration’ blog post.

In the hours following, we will be minting all REP token holders an equivalent amount of REP on the new REP contract, which will be the REP contract going forward.

There is no threat of loss of funds.

What we need from you:

1. Change the REP contract address from the old one to the new one after we have confirmed a successful migration.

---

Contract Freeze Time: July 9th, 2017 @ 11:01AM PST

This is expected to be a smooth migration, and the Augur team is on-call to assist with anything you may need. We will follow up with you (5) five days prior to deployment day, the day of, and then after the migration is complete with the updated REP contract address.

Please confirm with us that you’ve received this message and that you intend to follow the steps above upon contract freeze time. We will follow up this email in (7) seven days if we do not hear back.

If this is not the correct point of contact, we would kindly appreciate the message routed to the appropriate personnel on your team.

Thanks,

Tom Kysar

Add website, logo, community, github, support Veros {VRS}

Add website, logo, community, github, support Veros {VRS} (https://etherscan.io/token/0x92e78dae1315067a8819efd6dca432de9dcde2e9)

• https://github.com/ethereum-lists/tokens/blob/master/tokens/eth/0x92E78dAe1315067a8819EFD6dCA432de9DCdE2e9.json
  Replace on
• https://github.com/criptoredfox/tokens/blob/patch-1/tokens/eth/0x92E78dAe1315067a8819EFD6dCA432de9DCdE2e9.json

Add date

as a follow-up from #32 and mitigate this problem we will need an date where the token was added in in the metadata

Check address is EIP-55

Earn and get free

remove old/new suffix

follow-up of #186

I think it would be better to have these at the edge - so e.g. they can be localized. But it needs to be coordinated with the other projects. Or we do different exports. Just a follow up to not forget about this. cc @blurpesec

BQX token should be named ETHOS

The BQX (Bitquence) token, contract 0x5Af2Be193a6ABCa9c8817001F45744777Db30756, changed its name on november 2017 and is now called ETHOS.

See these links for further infos:

• https://www.ethos.io/2017/11/20/why-ethos/
• https://coinmarketcap.com/currencies/ethos/
• https://etherscan.io/token/0x5af2be193a6abca9c8817001f45744777db30756

Old contract address for the ANT token in the Next wallet

I understand that this is not the top priority, but just for you to know, in the case of ANT, the Next wallet only has the old contract address: 0x960b236A07cf122663c4303350609A66A7B288C0 - (and it is not marked as "old")

Due to that, one of the customers has sent an old ANT token to an exchange, which now has trouble with recovering it. - (They should be able to do that without any problems, although, it would be better to prevent this from happening)

Trezor Suite, however, recognizes the new token. The problem is, therefore, only within the Next wallet.

build fails on Arch linux with openJDK

Preface: I have no experience at all with gradle & kotlin, so bear with me if it is a stupid error :)

What i did:

1. checkout project
2. run "./gradlew build"

Task :compileTestKotlin FAILED
w: Runtime JAR files in the classpath should have the same version. These files were found in the classpath:
/home/michael/.gradle/caches/modules-2/files-2.1/org.jetbrains.kotlin/kotlin-reflect/1.2.71/7512db3b3182753bd2e48ce8d345abbadc40fe6b/kotlin-reflect-1.2.71.jar (version 1.2)
/home/michael/.gradle/caches/modules-2/files-2.1/org.jetbrains.kotlin/kotlin-stdlib/1.3.21/4bcc2012b84840e19e1e28074284cac908be0295/kotlin-stdlib-1.3.21.jar (version 1.3)
/home/michael/.gradle/caches/modules-2/files-2.1/org.jetbrains.kotlin/kotlin-stdlib-common/1.3.21/f30e4a9897913e53d778f564110bafa1fef46643/kotlin-stdlib-common-1.3.21.jar (version 1.3)
w: Consider providing an explicit dependency on kotlin-reflect 1.3 to prevent strange errors
w: Some runtime JAR files in the classpath have an incompatible version. Consider removing them from the classpath
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (2, 12): Unresolved reference: junit
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (7, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (14, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (21, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (29, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (37, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (44, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (51, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (58, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (65, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (73, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (81, 6): Unresolved reference: Test
e: /home/michael/WebstormProjects/tokens/src/test/kotlin/TheTokenChecker.kt: (88, 6): Unresolved reference: Test

FAILURE: Build failed with an exception.

• What went wrong:
  Execution failed for task ':compileTestKotlin'.
  Compilation error. See log for more details

This is running on Arch linux with openJDK:

openjdk version "11.0.3" 2019-04-16
OpenJDK Runtime Environment (build 11.0.3+4)
OpenJDK 64-Bit Server VM (build 11.0.3+4, mixed mode)

Make sure website is valid

Prevent extra "," in json objects

context #98

Add hash to ignore list

currently we ignore by address. We should ignore by address and content hash

context #396

Contract Metadata JSON

We should gather contract metadata json files. So:

1. Ask on every PR to request it.
2. UI's should indicate when contract metadata was not provided (as kind of a penalty/shaming) - ( cc @tayvano )
3. perhaps mail all contacts we have gathered here that they should provide the contract metadata (perhaps with hint to 2.)

context:

• https://solidity.readthedocs.io/en/v0.4.24/metadata.html
• trufflesuite/truffle#1118

Update "DGX" to be DGX2.0 token instead of the old DGX1.0

The old DGX1.0 token should be labeled as "DGX1", and DGX2.0 should be added as "DGX".

Details of DGX 2.0 token, as taken from etherscan:

• Address: 0x4f3afec4e5a3f2a6a1a411def7d7dfe50ee057bf
• Symbol: DGX
• Decimals: 9

Prevent symbol duplicates with name/icon that is the same for humans

depens on #116

When there is a token that has the same symbol as an token that has a date before the date of the token. Then fail the build if it does not have a section duplicates that point to the old token.

Then when reviewing PRs - the reviewer can check the duplicates if the name or the icon is the same for humans or if it is an attempt to create a disguise.

This is an attempt to close #32

Bnb

Adding BEP20 (BSC) tokens

Hello, kindly inform is it possible to add BEP20 (BSC) tokens into Trezor's list of Supported coins & tokens?
Into This list https://trezor.io/coins/

HAV tokens - address change

I noticed that the HAV tokens was replaced with 'new' ones in my ethereum address.

It changed from this contract 0xf244176246168f24e3187f7288edbca29267739b to this one 0xc011a72400e58ecd99ee497cf89e3775d4bd732f.

When accessing my ETH wallet via MyCrypto it shows the original HAV as 0 and does not 'see' the new ones. (I know it is there)

I logged the issue with MyCrypto but they referred me here so I just wanted to raise it.

Thanks

remove VIU token

The file eth/0x519475b31653E46D20cD09F9FdcF3B12BDAcB4f5.json contains a link to "https://viuly.io" website, which is the website of this token.

This website is marked as malware in Google Safe Browsing database. I suggest removing this token completely from the lists.

add check for deprecation

if there is a new address in deprecation - make sure it exists

Add optional field to mark token as suspicious

The end goal is to have an optional boolean field called suspicious which will mark the token as suspicious. This will be tracked with the git commit but will be used in (hopefully) good faith to mark tokens that are not the official ones as suspicious - such as fake governance tokens.

See https://twitter.com/sniko_/status/1279874748546154499 for more information

Remove xHNS

https://github.com/ethereum-lists/tokens/blob/master/tokens/eth/0x147c9130C5809367c5f2da7be0D6355D2795B081.json

This token:

• Does not have a logo
• Does not have any social presence
• Support website and email are dead (https://www.xfutures.io/)
• Official website links to https://handshake.org which is NOT an Ethereum token

This is showing up on Trezor's coins page (and incorrectly links to handshake.org as Homepage).

I didn't find any info on policies/guidelines on what kind of tokens are allowed here, so creating this issue instead of a PR so that:

• The token can be removed from this list
• The website field can be removed
• The redFlags field can be set so that it is "treated with caution" (does this also show up on Trezor's page?)

or a combination of the above.

Symbol constraints

especially after: walleth/walleth#210 I think decimals should really be limited

constraint to perhaps use:

• no "(" or ")"
• no space

cc @tayvano

Support token-updates deprecation

follow-up from #84

Often token contracts get updated - but information about this update is not directly machine readable from this repo - but hidden in PRs.

To solve this we should add this to the model for the JSON:

data class Deprecation(
        val new_address: String,
        val announcement_url: String? = null,
        val deprecation_time: String? = null, // ISO8601
        val migration_type: String? = null // currently only "auto" is allowed
)

time can be really handy so we can merge and roll out the software before the fact and do not have to rush things when the time for a comes for a token update.
Only new_address is mandatory - but we should urge to get at least an announcement_url as additional information. We often ask for the official announcement in the PR anyway to know if this is a legitimate update.

import from atomiclabs/cryptocurrency-icons

there might be some icons in there that we are missing:

https://github.com/atomiclabs/cryptocurrency-icons

https://www.reddit.com/r/etherscan/comments/rhc4dz/urgenthow_to_withdraw_coin_money_from_etherscan/?utm_source=share&utm_medium=mweb

https://www.reddit.com/r/etherscan/comments/rhc4dz/urgenthow_to_withdraw_coin_money_from_etherscan/?utm_source=share&utm_medium=mweb

add GRG token

please add GRG token on mainnet:
0x4FbB350052Bca5417566f188eB2EBCE5b19BC964.json

{
"symbol": "GRG",
"name": "Rigo Token",
"type": "ERC20",
"address": "0x4FbB350052Bca5417566f188eB2EBCE5b19BC964",
"ens_address": "",
"decimals": 18,
"website": "",
"logo": {
"src": "https://etherscan.io/token/images/rigotoken_28.png",
"width": "28",
"height": "28",
"ipfs_hash": ""
},
"support": {
"email": "",
"url": ""
},
"social": {
"blog": "",
"chat": "",
"facebook": "",
"forum": "",
"github": "",
"gitter": "",
"instagram": "",
"linkedin": "",
"reddit": "",
"slack": "",
"telegram": "",
"twitter": "",
"youtube": ""
}
}

TrueUSD (TUSD) token contract address changed

Per https://blog.trusttoken.com/scnote-33ec9f1fdb32 and https://etherscan.io/address/0x8dd5fbce2f6a956c3022ba3663759011dd51e73e, the TUSD token contract address has changed from 0x8dd5fbCe2F6a956C3022bA3663759011Dd51e73E to 0x0000000000085d4780B73119b644AE5ecd22b376

MOVR

Duplicate token symbols (from MEW import?)

Both of these are "DOW":

• https://github.com/ethereum-lists/tokens/blob/master/tokens/eth/0x76974C7B79dC8a6a109Fd71fd7cEb9E40eff5382.json
• https://github.com/ethereum-lists/tokens/blob/master/tokens/eth/0xEEF6E90034eEa89E31Eb4B8eaCd323F28A92eaE4.json

Looks like one just came in from the MEW import. Might need to find a way to de-dupe these before importing.

492 (1080×1988)

Enforce consistent decimal typing

Most decimals are strings, but some are numbers. Would be good to keep these consistent for anything typed that cares about that.

Decimal example: https://github.com/ethereum-lists/tokens/blob/master/tokens/eth/0x1063ce524265d5a3A624f4914acd573dD89ce988.json

SNX token has an outdated contract address in the Trezor Suite wallet.

The users of Suite wallet report that it doesn't load their SNX tokens. Considering that the token is rank 27 on the CMC, it should be updated.

I'm unsure of what contract address is specified currently for the SNX token, however, the up to date contract address is: 0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f

This is a great project, using it for a python module i built

https://pypi.org/project/pyetherbalance/

Bnb

kontinuum/run fails

#395
the run job failed on this PR (though the issue seems to be with an earlier commit)
and our PR as a result is still not reflected in Trezor

Issue retrieving token list from gateway - 504 timed out

It seems that the gateway is timing out for me; I'm trying to get the tokens for the Ambo project, but we're having issues hitting the gateway to retrieve the complied token list. Do you have a cached copy available somewhere?

Sorry for this!