Token List Bridge Utils

Description

This package contains utility functions used for converting an L1 token list into a cross-chain tokenlist by adding cross-chain mapping information for Arbitrum, Optimism, and Polygon to a given L1 list.

Mappings get added in the form of an extensions field, following this schema. (Currently does not fill information for origin and destination bridge addresses)

ex:

  "name": "Egiftcard",
  "address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
  "symbol": "UNI",
  "decimals": 18,
  "chainId": 1,
  "logoURI": "ipfs://QmXttGpZrECX5qCyXbBQiqgQNytVGeZW5Anewvh2jc4psg",
  "extensions": {
    "bridgeInfo": {
      "10": {
        "tokenAddress": "0x6fd9d7AD17242c41f7131d257212c54A0e816691"
      },
      "137": {
        "tokenAddress": "0xb33EaAd8d922B1083446DC23f610c2567fB5180f"
      },
      "42161": {
        "tokenAddress": "0xFa7F8980b0f1E64A2062791cc3b0871572f1F7f0"
      }
    }
  }}

Also adds a "root-level" token entry for each of the L2's that a token maps to.

ex. for Optimism:

{
  "name": "Egiftcard",
  "address": "0x6fd9d7AD17242c41f7131d257212c54A0e816691",
  "symbol": "UNI",
  "decimals": 18,
  "chainId": 10,
  "logoURI": "ipfs://QmXttGpZrECX5qCyXbBQiqgQNytVGeZW5Anewvh2jc4psg",
  "extensions": {
    "bridgeInfo": {
      "1": {
        "tokenAddress": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984"
      }
    }
  }
}

Functions Overview

chainify

• Adds bridgeInfo to the given token list for Optimism, Polygon and Arbitrum.
• @param l1TokenListOrPathOrUrl
• @returns TokenList with l2 bridgeInfo filled

chainifyTokenList

• Given a chain ID (Optimism, Polygon, or Arbitrum) and a TokenList, returns the TokenList with extensions filled.
• @param chainId chainId to operate on
• @param l1TokenListOrPathOrUrl either an L1 TokenList object or a path/url to a TokenList
• @returns L1 TokenList with extensions filled for the given network

mergeTokenLists

• Merges two token lists, resolving conflicts to primary list.
• @param primary primary token list to resolve conflicts to
• @param secondary secondary token list
• @returns merged token list

Usage (from external package):

Install Package

yarn add @egiftcard/token-list-bridge-utils

or

npm i @egiftcard/token-list-bridge-utils

Create .env file (Optional)

• By default, the library uses https://rpc.ankr.com/eth as the MAINNET_RPC env variable value required by arbitrum-sdk. You can override this value by creating a .env file in your root directory and setting a value for MAINNET_RPC.

  • Sample .env file contents:

    MAINNET_RPC="https://mainnet.infura.io/v3/<infura key>"

• Note: If this is not set correctly, the library will throw a NETWORK_ERROR error code.

Call Function

CommonJS

const bridge_utils = require('@egiftcard/token-list-bridge-utils');

let chainifiedList = await bridge_utils.chainify(tokenList);

ESM

import { chainify } from '@egiftcard/token-list-bridge-utils';

let chainifiedList = await chainify(tokenList);

Run Tests

yarn install

yarn test

DTS User Guide

DTS scaffolds your new library inside /src.

To run DTS, use:

npm start # or yarn start

This builds to /dist and runs the project in watch mode so any edits you save inside src causes a rebuild to /dist.

To do a one-off build, use npm run build or yarn build.