Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@uniswap/token-list-bridge-utils

Package Overview
Dependencies
Maintainers
8
Versions
23
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@uniswap/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.

  • 1.1.0
  • npm
  • Socket score

Version published
Weekly downloads
35
increased by75%
Maintainers
8
Weekly downloads
 
Created
Source

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": "Uniswap",
  "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": "Uniswap",
  "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 @uniswap/token-list-bridge-utils

or

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

Create .env file (Optional)

  • By default, the library uses https://cloudflare-eth.com/ 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('@uniswap/token-list-bridge-utils');

let chainifiedList = await bridge_utils.chainify(tokenList);

ESM

import { chainify } from '@uniswap/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.

FAQs

Package last updated on 19 Oct 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc