Skip to content

token-list 1.6.1

Install from the command line:
Learn more about npm packages
$ npm install @perspectivefi/token-list@1.6.1
Install via package.json:
"@perspectivefi/token-list": "1.6.1"

About this version

Spectra Token List

Overview

As Spectra, we use this repository as source of the tokens & platforms for our Web3 app as well as other services. This list is updated regularly as new tokens are added to the platform.

Tokens and Protocols

How to add a token

Expected structure - src/tokens/spectraTokens.json

chainId address symbol name decimals logoURI extensions
1 0x6def54ae7e38992a7d1ab60d279483ba7f7b0aeb KweETH Wrapped Ether 18 /images/tokens/weETH.svg underlying, ibtRoutes, protocol, faucetAddress, aprEndpoint

Steps:

  1. Create a new branch from the main with the name chore/token-<token-symbol>-<chain-id>
  2. Add the token to the src/tokens/spectraTokens.json file

Example:

[
  ...
  {
    "chainId": 1,
    "address": "0x4104b135dbc9609fc1a9490e61369036497660c8",
    "name": "Spectra",
    "symbol": "APW",
    "decimals": 18,
    "logoURI": "images/tokens/apw.svg"
  }
]
  1. Add the token logo to the src/images/tokens folder (use .png or .svg format)
  2. Commit the changes with the message: chore: add <token-symbol>, chainId: <chain-id>
  3. Create a pull request
  4. Once the PR is approved, the token will be added to the list and included in the Spectra platform in the next build.
  5. Done

How to add a protocol

Expected structure - src/protocols/protocolList.json

ptAddress chainId protocolName bgUrl token.symbol token.logoURI token.underlying multipliers.amount multipliers.name
0x6def54ae7e38992a7d1ab60d279483ba7f7b0aeb 1 Karak images/textures/etherfiBackground.svg KweETH images/tokens/weETH.svg weETH 1.5 Karak XP

Steps:

  1. Create a new branch from the main with the name chore/protocol-<protocol-name>-<chain-id>
  2. Add the protocol to the src/protocols/protocolList.json file

Example:

[
  ...
  {
    "ptAddress": "0x6def54ae7e38992a7d1ab60d279483ba7f7b0aeb",
    "chainId": 1,
    "protocolName": "Karak",
    "bgUrl": "images/textures/etherfiBackground.svg",
    "token": {
      "symbol": "KweETH",
      "logoURI": "images/tokens/weETH.svg",
      "underlying": "weETH"
    },
    "multipliers": [
      {
        "amount": 1.5,
        "name": "Karak XP"
      },
      {
        "amount": 3,
        "name": "Ether.fi Points"
      },
      {
        "amount": 1,
        "name": "EigenLayer Points"
      }
    ]
  }
]
  1. Add the protocol background image to the src/images/textures folder (use .png or .svg format)
  2. Commit the changes with the message: chore: add <protocol-name>, chainId: <chain-id>
  3. Create a pull request
  4. Once the PR is approved, the protocol will be added to the list and included in the Spectra platform in the next build.
  5. Done

How to add a custom protocol content to the Spectra web3 application

Expected structure - src/protocols/protocolCustomContent.tsx

YT pendingPoints helpText
Each YT is entitled to all the extra yield and point on top of one weETH deposit in Karak (with the multiplier). Integration of Ether.fi Points portfolio is underway. View your Points on the Ether.fi dashboard. Karak is a yield farming protocol that allows users to earn extra yield and points on top of their weETH deposits.

Steps:

  1. Create a new branch from the main with the name chore/protocol-content-<protocol-name>-<chain-id>
  2. Add the protocol content to the src/protocols/protocolCustomContent.tsx with pt address as key and the custom content properties as value
const protocolCustomContent: Record<string, ProtocolText> = {
    "0x6def54ae7e38992a7d1ab60d279483ba7f7b0aeb": {
        YT: "Each YT is entitled to all the extra yield and point on top of one weETH deposit in Karak (with the multiplier).",
        pendingPoints: (
            <>
                Integration of Ether.fi Points portfolio is underway.
                <br/>
                <br/>
                View your Points on the{" "}
                <a
                    href="https://www.ether.fi/"
                    target="_blank"
                    className="underline"
                >
                    Ether.fi dashboard
                </a>
                .
            </>
        ),
    },
};
  1. Commit the changes with the message: chore: add <protocol-name> content, chainId: <chain-id>
  2. Create a pull request
  3. Once the PR is approved, the protocol content will be added to the list and included in the Spectra platform in the next build.
  4. Done

How to add a ERC4626 wrapper

Expected structure - src/tokens/erc4626Wrappers.json

chainId address symbol name decimals logoURI extensions
1 0x6def54ae7e38992a7d1ab60d279483ba7f7b0aeb KweETH Wrapped Ether 18 /images/tokens/weETH.svg underlying, ibtRoutes, protocol, aprEndpoint, vault

Steps:

  1. Create a new branch from the main with the name chore/wrapper-<token-symbol>-<chain-id>
  2. Add the wrapper to the src/tokens/erc4626Wrappers.json file
  3. Commit the changes with the message: chore: add <token-symbol> wrapper, chainId: <chain-id>
  4. Create a pull request
  5. Once the PR is approved, the wrapper will be added to the list and included in the Spectra platform in the next build.
  6. Done

Details


Assets

  • token-list-1.6.1.tgz

Download activity

  • Total downloads 100
  • Last 30 days 100
  • Last week 100
  • Today 11