galleon token list

npm: https://www.npmjs.com/package/@galleondao/galleon-tokenlist

github: https://github.com/GalleonDAO/galleon-tokenlist

Install

yarn add @galleondao/galleon-tokenlist

Usage

import {
  MainnetTokens,
  MaticTokens,
  GalleonMainnetTokens,
  GalleonMaticTokens,
  TokenData,
} from '@galleondao/galleon-tokenlist';

• GalleonMainnetTokens: Only Galleon Mainnet tokens
• GalleonMaticTokens: Only Galleon Matic network tokens
• GalleonArbitrumTokens: Only Galleon Arbitrum roll-up tokens
• GalleonOptimismTokens: Only Galleon Optimism roll-up tokens
• GalleonAvalanceTokens: Only Galleon Avalanche network tokens
• TokenData: The token interface used by the lists

Contributing

npm run commit

REQUIRED: Due to the use of semantic-release for deploying to npm's registry, we require commits to be formatted a specific way. This is made easy by the above npm script. If your commit doesn't use the above command for styling, it won't be picked up by semantic-release for publishing.

Adding Galleon Tokens

When adding Galleon tokens, find the Galleon specific array in the appropriate network file and append the Galleon list at the top as shown below.

const GALLEON_MAINNET_TOKENS: TokenData[] = [
  {
    address: '0x47110d43175f7f2c2425e7d15792acc5817eb44f',
    chainId: 1,
    name: 'My New Index',
    symbol: 'MNI',
    decimals: 18,
    logoURI:
      'path-to-hosted-logo',
  },
  {...}
];

Adding non-Galleon Tokens

When adding any other token, find the generic array in the appropriate network file and append the second array at the bottom as shown below.

const MAINNET_TOKENS: TokenData[] = [
  {
    address: '0x47110d43175f7f2c2425e7d15792acc5817eb44f',
    chainId: 1,
    name: 'My New Token',
    symbol: 'MNT',
    decimals: 18,
    logoURI:
      'path-to-hosted-logo',
  },
  {...}
];

Adding a new network

When adding a new network, create a new file in src/lists named after the network, and copy the structure from any of the other lists. File should include at a minimum:

• An exported GALLEON_NEW_NETWORK_TOKENS TokenData array, containing only Galleon tokens on that network.
• A default exported NEW_NETWORK_TOKENS TokenData array, containing all tokens on that network, with the last item appended being the aforementioned GALLEON_[NETWORK]_TOKENS array.

After this, index.ts should be updated to export the newly created lists as shown below:

export const NewNetworkTokens = NEW_NETWORK_TOKENS;
export const GalleonNewNetworkTokens = GALLEON_NEW_NETWORK_TOKENS;

When these are complete, update the Usage list above to show what lists are available to a user.