Uniswap’s token list standard: Improving UX/UI on AMMs

How to improve Uniswap’s security and usability for Tokamak network users?

Suah Kim
Tokamak Network
3 min readSep 29, 2022

--

Introduction

Uniswap (and other swap dapp) has significantly increased interoperability and provided the backbone to other dapps that require decentralized pricing oracle or swap.

One of the main concerns for users is that the Uniswap interface does not provide a reliable list of tokens that can be swapped. This comes from the fact that many new tokens are created every day and existing tokens become worthless.

Sometimes there are multiple tokens with the same name confusing the user. For example, TON, which is Tokamak network’s token is also the name for another project called “Toncoin” and “TON token”. I will not provide the links for the mentioned projects, but you can easily search for them on a search engine.

What is Uniswap’s token list standard?

To avoid and reduce confusion among users while reducing their responsibility and token list centralization, Uniswap came up with a clever plan: “Token list standard”.

Token list standard is a list of ERC20 token information saved in JSON format. The idea is that services should provide a curated token list that their users can use to for swapping their tokens on Uniswap. This way, the user just has to add the token list and does not have to worry about accidentally swapping tokens with a similar name and don’t have to search for token addresses.

Furthermore, the service can include a token image to the JSON file to improve the overall UX/UI.

Token list standard for Tokamak network

To improve the UX/UI for Tokamak users, I have made Tokamak network tokens specific JSON file which can be used to import on Uniswap.

The token list includes

  • WTON: wrapped Tokamak network token (TON)
  • TOS: TONStarter(launchpad)’s utility token
  • Project tokens: tokens from TONStarter launchpad, such as DOC, AURA, and LYDA. This will be updated as a new project is launched from TONStarter

How to use:

  1. Go to https://app.uniswap.org/#/swap?chain=mainnet
  2. Click on “Select token” red button

3. Click on “Manage Token Lists” on the bottom

4. Under Lists input box, paste https://onther-tech.github.io/uniswapv3-token-list-onther/onther.tokenlist.json

5. Select “Import”

6. Select the back arrow on the top left

7. Congratulations! You should be able to search tokens related to Tokamak network such as WTON and TOS

Hint: if you have already added these tokens, the token logo will not display; if you remove them and add them back using the token list, the logo will show!

Github Code: https://github.com/Onther-Tech/uniswapv3-token-list-onther

Small TOSv2 update

And for those of you who have been waiting for TOSv2 updates, I am sorry that it is taking a very long time to open, but our team is working around the clock to check for bugs and modeling faults. We are almost done!

One snippet I can share about TOSv2 progress is that we will soon open our phase 1 public test (on Goerli network) for our users, and you can earn TOS rewards by participating in it.

I recommend all TON/TOS supporters join the phase 1 public test, because we may contact you in the future for more juicy events and benefits (I cannot say what they are, but better join than not join right?)

Anyways, thanks everyone for all your support!

--

--

Suah Kim
Tokamak Network

Ph.D in information security, researcher @ Tokamak Network