Skip to content

Latest commit

 

History

History
98 lines (60 loc) · 4.78 KB

erc20-tutorial.en.md

File metadata and controls

98 lines (60 loc) · 4.78 KB

ERC20 Token Profile Submission Guideline

Check Token Profile Guideline

Requirements

Information Preparation

Complete project information and related blockchain media reports are appreciated, including but not limited to the following items:

  • Project team background:
  • Project basic information:
  • Media publications:
  • Supported Exchanges:
  • Suggested Gas limit setting (default is 60,000):

Token Profile Submission:

Sample Pull Request (PR): https://github.com/consenlabs/token-profile/pull/1636/files

Requirements to the information

Completeness and Accuracy of the information

You are responsible for the information you submitted. Please ensure that the token information submitted is concise and accurate. Please refer to the sample PR. Complete information of your project can help imToken team understand your project better, which may speed up the review process.

Logo Design Requirements

  • Size: 120x120 pixels
  • Transparent background PNG format
  • Brand logo horizontally and vertically centered, as shown below.

example

How it works

We recommend that you complete the procedures with your developers

  1. Fork the repo to your own github account

  2. Clone the repo from your own account, please note: do no clone the origin one directly, but clone the repo you forked

git clone [email protected]:xxxxxxxx/token-profile.git
cd token-profile/
  1. Create a new branch (file) and switch to a new branch named by your token symbol For example:
git branch xxx-token
git checkout xxx-token

  1. Add a new json file to the erc20 directory, named by your token contract address. Please note the contract address should be done with capitalization with checksum For example: 0xf90f1648926005A8bb3ed8ec883164De7F768743.json

  2. Please ensure to use UTF-8 encoding in the json file to avoid Travis-CI build error. Please check the template file to fill in the complete token information: $template.json

  3. Add the token logo to images directory, name it by the token contract address with checksum .

  4. Commit and push the information to your repo For example:

git add -A
git commit -m “Add xxx token”
git push origin xxx-token

  1. Under your repo page, click the “New pull request” button. Then, attach the detailed project information and related blockchain media reports. This includes but not limited to the following: (Project team background; Project basic information; Media publications; Supported Exchanges; Suggested Gas limit setting).

    Sample PR: consenlabs#1636

  2. We will review your PR as soon as possible. If there is no problem with your PR, we will merge it into our master branch. And then your token profile will display in the current imToken App

Frequently asked questions

How to display token price:

In imToken, the current displayed token prices are provided by the block.cc API. If you want your project’s token price to be displayed in imToken, your token price must be supported on block.cc and you have to provide us the corresponding link. Please refer to this page for more information: https://mifengcha.com/q/eth

Regarding Duplicated Token Names or Contract Amendment

In imToken 1.0, if duplicated token names are found, imToken team will add a number after the token name for the project, like TFT1, TFT2 etc. If you wish to remove the number, we need to claim, this is a very dangerous operation. Removing the number is not advisable, as amending the token name will cause the token to disappear from imToken display and may cause unnecessary panic among users. For tokens with many holders, we recommend the token project to suggest to your users, to download and use imToken 2.0, as imToken 2.0 distinguish tokens via contract address. Therefore, this mitigates the problem of duplicated token names.

If there are update requests due to contract amendment, projects are required to make an official announcement for respective community for the change of Symbol, and inform users about the need to search and add the token again in imToken. Besides, please submit a new PR in GitHub, add on _OLD to the old contract Symbol (e.g. TFT_OLD), and then resubmit new token contract and logo, as shown in the picture below. Please share your announcement link under the comment section in the PR, imToken team will evaluate the situation.

old

Unable to search via contract address

If you can't search via the contract address, please check if there is no successful transaction records. Besides, please verify your contract information on [Etherscan] (https://etherscan.io/), then we can help you manually add it.

Copyright

2018©imToken PTE. LTD.