README.md

Netswap Tokenlists

Token Lists is a specification for lists of token metadata (e.g. address, decimals, etc.) that can be used by any dApp interfaces that needs one or more lists of tokens. Anyone can create and maintain a token list, as long as they follow the specification. The Netswap community invites you to add your token to our tokenlists!

Adding Your Token to an Existing List

General Requirements

1. Token should be verified on the andromeda explorer.
2. Token must be added to a list that it qualifies for:
   • Top 15 Tokenlist: Token must be in the top 15 of eligible Metis tokens by marketcap.
   • MB Tokenlist: Token must be bridgeable on the Metis Bridge.
   • oPortal Bridge Tokenlist: Token must be bridgeable on the oPortal Bridge.
   • DeFi Tokenlist: Token must be connected to a DeFi protocol running on Metis.
   • Stablecoin Tokenlist: Token must be a stablecoin.
   • Test Tokenlist: Token must be in the stardust network, which is a test network of Metis.

Adding Your Token

1. Add an entry in the tokens field of the appropriate tokenlist. Here is an example using WETH:

   {
       "address": "0x420000000000000000000000000000000000000A",
       "chainId": 1088,
       "name": "Ether",
       "symbol": "WETH",
       "decimals": 18,
       "logoURI": "https://raw.githubusercontent.com/MetisProtocol/metis-bridge-resources/master/tokens/ETH/logo.png"
   }

2. Update the timestamp field to the current timestamp.

3. Update the version field to adhere to semantic versioning:

   • Increment major version when tokens are removed
   • Increment minor version when tokens are added
   • Increment patch version when tokens already on the list have minor details changed (name, symbol, logo URL, decimals)

   Note: Changing a token address or chain ID is considered both a remove and an add, and should be a major version update.

Creating Your Own List

List creation is encouraged! The Netswap team wants the community to develop their own lists and will not gatekeep new lists.

Adding Your Token Logo

Netswap token logos are hosted here.